<!DOCTYPE HTML PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html><head>









 
 
 


  

  



  
    
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>KML Reference - KML - Google Code</title>
<script type="text/javascript"><!--
(function(){function a(){this.t={};this.tick=function(c){this.t[c]=(new Date).getTime()};this.tick("start")}var b=new a;window.jstiming={Timer:a,load:b};if(window.external&&window.external.pageT)window.jstiming.pt=window.external.pageT;})();

var _tocPath_ = '/html/apis/kml/documentation/_toc.ezt';
//--></script>
<link href="kmlreference22_ext-Dateien/codesite.css" type="text/css" rel="stylesheet">
<script src="kmlreference22_ext-Dateien/codesite_head.js" type="text/javascript"></script>
<script type="text/javascript">CODESITE_CSITimer['load'].tick('bhs');</script>
<link rel="search" type="application/opensearchdescription+xml" title="Google Code" href="http://code.google.com/osd.xml">

<!--[if IE]><link rel="stylesheet" type="text/css" href="/css/iehacks.css" /><![endif]-->

<link href="kmlreference22_ext-Dateien/local_extensions.css" rel="stylesheet" type="text/css">
  </head><body linkifying="true" class="gc-documentation">

    
    
    


<div id="gb">
 <span>
  
   
    <b>bachmann.florian@gmail.com</b>
    |
   
   
    <a href="http://code.google.com/u/bachmann.florian/" id="projects-dropdown" onclick="return false;">My favorites</a><img class="menuIcon off" id="menuIcon-projects-dropdown" src="kmlreference22_ext-Dateien/cleardot.gif" height="14" width="14">
    |
   
  
    <a id="lang-dropdown" class="dropdown" href="http://code.google.com/" onclick="return false;"><img class="globeicon" src="kmlreference22_ext-Dateien/globe2_small.png" height="13" width="13"><span>English</span></a><img class="menuIcon off" id="menuIcon-lang-dropdown" src="kmlreference22_ext-Dateien/cleardot.gif" height="14" width="14">
  
   
    | <a href="http://www.google.com/accounts/Logout?continue=http%3A%2F%2Fcode.google.com%2Fintl%2Fde%2Fapis%2Fkml%2Fdocumentation%2Fkmlreference.html" onclick="CODESITE_click('/gb/sc/signout');">Sign out</a>
   
  
 </span>
</div>

<div class="gbh" style="left: 0pt;"></div>
<div class="gbh" style="right: 0pt;"></div>



<div id="gc-container">
<a name="top"></a>
<div id="skipto">
  <a href="#gc-pagecontent-anchor">Skip to page content</a>
  <a href="#gc-toc-anchor">Skip to main navigation</a>
</div>

<div id="gc-header">
  <div id="logo"><a href="http://code.google.com/">
  
  
     <img src="kmlreference22_ext-Dateien/code_logo.png" alt="Google Code" style="border: 0pt none ; margin: 3px 0pt 0pt;" height="40" width="161">
  
  
  </a></div>
  <div id="search">
    <div id="searchForm" class="searchForm">
      <form id="cse" action="http://www.google.com/cse" accept-charset="utf-8" class="gsc-search-box" onsubmit="executeGSearch(document.getElementById('gsearchInput').value); return false;">
      <noscript>
      <input type="hidden" name="cref" value="http://code.google.com/cse/googlecode-context.xml"/>
      </noscript>
        <table class="gsc-search-box" cellpadding="0" cellspacing="0">
          <tbody>
            <tr>
              <td class="gsc-input">
                <input id="gsearchInput" name="q" maxlength="2048" class="gsc-input" autocomplete="off" title="Google Code Search" style="width: 345px;" type="text">
              </td>
              <td class="gsc-search-button">
                <div id="cs-searchresults" onclick="event.cancelBubble = true;"></div>
                <input title="Search" id="gsearchButton" class="gsc-search-button" name="sa" value="Search" type="submit">
              </td>
            </tr>
            <tr>
              <td colspan="2" class="greytext">e.g. "ajax apis" or "open source"</td>
            </tr>
          </tbody>
        </table>
      </form>
    </div> <!-- end searchForm -->
  </div> <!-- end search -->
</div> <!-- end gc-header -->


<div id="codesiteContent">

<a name="gc-topnav-anchor"></a>
<div id="gc-topnav"><img id="gc-star" src="kmlreference22_ext-Dateien/star_off.gif" height="15" width="15">
  <h1 class="mozilla">KML</h1>
  <ul id="docs" class="gc-topnav-tabs">

    <li id="home_link">
      <a href="http://code.google.com/apis/kml/" title="KML home page">Home</a>
    </li>
  
    <li id="docs_link">
      <a href="http://code.google.com/apis/kml/documentation/" class="selected" title="Official KML documentation">Docs</a>
    </li>
  
    <li id="faq_link">
      <a href="http://code.google.com/apis/kml/faq.html" title="Answers to frequently asked questions about KML">FAQ</a>
    </li>
  
    <li id="articles_link">
      <a href="http://code.google.com/apis/kml/articles/" title="Focused articles and tutorials for KML developers">Articles</a>
    </li>
  
    <li>
      <a href="http://googlegeodevelopers.blogspot.com/" title="Official KML blog">Blog</a>
    </li>
  
    <li>
      <a href="http://groups.google.com/group/kml-support" title="KML developer forum">Group</a>
    </li>
  

  </ul>
</div> <!-- end gc-topnav -->

    <div class="g-section g-tpl-190">

      <a name="gc-toc-anchor"></a>  
      <div class="g-unit g-first" id="gc-toc">
        
<ul class="treelist tlw-nested-only tlw-processed tlw-instance-0">
  <li><a href="http://code.google.com/apis/kml/documentation/mapsSupport.html" class="tlw-expanded tlw-ignore">KML in Google Maps</a>
    <ul>
			<li><a href="http://code.google.com/apis/kml/documentation/kmlelementsinmaps.html">KML/Maps Details</a></li>
		</ul>
	</li>
	<li><a href="http://code.google.com/apis/kml/documentation/kmlSearch.html">Submit Your Geo Content to Google</a></li>	
  <li><a href="http://kml-samples.googlecode.com/svn/trunk/interactive/index.html">Interactive Sampler</a></li>
</ul>

<div class="line"></div>
<ul class="treelist tlw-nested-only tlw-processed tlw-instance-1">
<li><h2 class="tlw-ignore">Documentation</h2>
	<ul>
		<li><a href="http://code.google.com/apis/kml/documentation/">Introduction</a></li>
		<li><a href="http://code.google.com/apis/kml/documentation/kml_tut.html">KML Tutorial</a></li>
		<li style="padding-top: 0pt; padding-bottom: 0pt;">
      <div class="tlw-title tlw-branch"><a href="javascript:void(0)" class="tlw-control" title="Expand Developer's Guide"><img src="kmlreference22_ext-Dateien/cleardot_002.gif" alt="Expand Developer's Guide" class="tlw-control tlw-plus"></a><a href="http://code.google.com/apis/kml/documentation/topicsinkml.html">Developer's Guide</a></div><ul style="display: none;" id="1-sub-0">
				<li><a href="http://code.google.com/apis/kml/documentation/touring.html">Touring</a><span class="new50"> New</span></li>
				<li><a href="http://code.google.com/apis/kml/documentation/altitudemode.html">Altitude Modes</a><span class="new50"> New</span></li>
				<li><a href="http://code.google.com/apis/kml/documentation/time.html">Time &amp; Animation</a><span class="new50"> Updated</span></li>
        <li><a href="http://code.google.com/apis/kml/documentation/cameras.html">Cameras</a><span class="new50"> Updated</span></li>
        <li><a href="http://code.google.com/apis/kml/documentation/photos.html">PhotoOverlays</a></li>
        <li><a href="http://code.google.com/apis/kml/documentation/kmlsky.html">Sky Data in KML</a></li>
        <li><a href="http://code.google.com/apis/kml/documentation/extendeddata.html">Adding Custom Data</a></li>
        <li><a href="http://code.google.com/apis/kml/documentation/models.html">Models</a></li>
        <li><a href="http://code.google.com/apis/kml/documentation/regions.html">Regions</a></li>
        <li><a href="http://code.google.com/apis/kml/documentation/updates.html">Updates</a></li>
        <li><a href="http://code.google.com/apis/kml/documentation/expiration.html">Expiration</a></li>
      </ul>
    </li>
		
		<li style="padding-top: 0pt; padding-bottom: 0pt;">
      <div class="tlw-title tlw-branch selected"><a href="javascript:void(0)" class="tlw-control" title="Collapse KML Reference"><img src="kmlreference22_ext-Dateien/cleardot_002.gif" alt="Collapse KML Reference" class="tlw-control tlw-minus"></a><a href="http://code.google.com/apis/kml/documentation/kmlreference.html">KML Reference</a></div><ul style="display: block;" id="1-sub-1"> 
      
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#abstractview">&lt;AbstractView&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#address">&lt;address&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#addressdetails">&lt;AddressDetails&gt;</a></li>
	  <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#alias">&lt;Alias&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#coordinates">&lt;altitude&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#altitudemode">&lt;altitudeMode&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#gxaltitudemode">&lt;gx:altitudeMode&gt;</a><span class="new50"> New</span></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#gxanimatedupdate">&lt;gx:AnimatedUpdate&gt;</a><span class="new50"> New</span></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#atomauthor">&lt;atom:author&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#atomlink">&lt;atom:link&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#atomname">&lt;atom:name&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#balloonstyle">&lt;BalloonStyle&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#gxballoonvisibility">&lt;gx:balloonVisibility&gt;</a><span class="new50"> New</span></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#begin">&lt;begin&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#bgcolor">&lt;bgColor&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#bottomfov">&lt;bottomFov&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#camera">&lt;Camera&gt;</a><span class="new50"> Updated</span></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#change">&lt;Change&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#color">&lt;color&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#colormode">&lt;colorMode&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#colorstyle">&lt;ColorStyle&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#container">&lt;Container&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#cookie">&lt;cookie&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#coordinates">&lt;coordinates&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#create">&lt;Create&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#data">&lt;Data&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#delete">&lt;Delete&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#description">&lt;description&gt;</a><span class="new50"> Updated</span></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#displaymode">&lt;displayMode&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#displayname">&lt;displayName&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#document">&lt;Document&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#draworder">&lt;drawOrder&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#gxduration">&lt;gx:duration&gt;</a><span class="new50"> New</span></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#east">&lt;east&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#end">&lt;end&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#expires">&lt;expires&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#extendeddata">&lt;ExtendedData&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#extrude">&lt;extrude&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#feature">&lt;Feature&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#fill">&lt;fill&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#gxflyto">&lt;gx:FlyTo&gt;</a><span class="new50"> New</span></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#gxflytomode">&lt;gx:flyToMode&gt;</a><span class="new50"> New</span></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#flytoview">&lt;flyToView&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#folder">&lt;Folder&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#geometry">&lt;Geometry&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#gridorigin">&lt;gridOrigin&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#groundoverlay">&lt;GroundOverlay&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#heading">&lt;heading&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#href">&lt;href&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#hotspot">&lt;hotSpot&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#httpquery">&lt;httpQuery&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#icon">&lt;Icon&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#iconstyle">&lt;IconStyle&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#imagepyramid">&lt;ImagePyramid&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#innerboundaryis">&lt;innerBoundaryIs&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#itemicon">&lt;ItemIcon&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#key">&lt;key&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#kml">&lt;kml&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#labelcolor">&lt;labelColor&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#labelstyle">&lt;LabelStyle&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#latitude">&lt;latitude&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#latlonaltbox">&lt;LatLonAltBox&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#latlonbox">&lt;LatLonBox&gt;</a></li>
	    <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#gxlatlonquad">&lt;gx:LatLonQuad&gt;</a><span class="new50"> New</span></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#leftfov">&lt;leftFov&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#linearring">&lt;LinearRing&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#linestring">&lt;LineString&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#linestyle">&lt;LineStyle&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#link">&lt;Link&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#linkdescription">&lt;linkDescription&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#linkname">&lt;linkName&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#linksnippet">&lt;linkSnippet&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#listItemType">&lt;listItemType&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#liststyle">&lt;ListStyle&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#location">&lt;Location&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#lod">&lt;Lod&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#longitude">&lt;longitude&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#lookat">&lt;LookAt&gt;</a><span class="new50"> Updated</span></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#maxaltitude">&lt;maxAltitude&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#maxfadeextent">&lt;maxFadeExtent&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#maxheight">&lt;maxHeight&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#maxlodpixels">&lt;maxLodPixels&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#maxsessionlength">&lt;maxSessionLength&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#maxwidth">&lt;maxWidth&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#message">&lt;message&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#minaltitude">&lt;minAltitude&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#minfadeextent">&lt;minFadeExtent&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#minlodpixels">&lt;minLodPixels&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#minrefreshperiod">&lt;minRefreshPeriod&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#model">&lt;Model&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#multigeometry">&lt;MultiGeometry&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#name">&lt;name&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#near">&lt;near&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#networklink">&lt;NetworkLink&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#networklinkcontrol">&lt;NetworkLinkControl&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#north">&lt;north&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#object">&lt;Object&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#open">&lt;open&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#orientation">&lt;Orientation&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#outerboundaryis">&lt;outerBoundaryIs&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#outline">&lt;outline&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#overlay">&lt;Overlay&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#overlayxy">&lt;overlayXY&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#pair">&lt;Pair&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#phonenumber">&lt;phoneNumber&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#photooverlay">&lt;PhotoOverlay&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#placemark">&lt;Placemark&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#gxplaylist">&lt;gx:Playlist&gt;</a><span class="new50"> New</span></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#gxplaymode">&lt;gx:playMode&gt;</a><span class="new50"> New</span></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#point">&lt;Point&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#polygon">&lt;Polygon&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#polystyle">&lt;PolyStyle&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#range">&lt;range&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#refreshinterval">&lt;refreshInterval&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#refreshmode">&lt;refreshMode&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#refreshvisibility">&lt;refreshVisibility&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#region">&lt;Region&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#resourcemap">&lt;ResourceMap&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#rightFov">&lt;rightFov&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#roll">&lt;roll&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#rotation">&lt;rotation&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#rotationxy">&lt;rotationXY&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#scale2">&lt;Scale&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#scale">&lt;scale&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#schema">&lt;Schema&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#schemadata">&lt;SchemaData&gt;</a></li>
	  <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#screenoverlay">&lt;ScreenOverlay&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#screenxy">&lt;screenXY&gt;</a></li>
	  <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#shape">&lt;shape&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#simpledata">&lt;simpleData&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#simplefield">&lt;SimpleField&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#size">&lt;size&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#snippet">&lt;Snippet&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#gxsoundcue">&lt;gx:SoundCue&gt;</a><span class="new50"> New</span></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#south">&lt;south&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#state">&lt;state&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#style">&lt;Style&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#stylemap">&lt;StyleMap&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#styleselector">&lt;StyleSelector&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#styleurl">&lt;styleUrl&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#targethref">&lt;targetHref&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#tessellate">&lt;tessellate&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#text">&lt;text&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#textcolor">&lt;textcolor&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#tilesize">&lt;tileSize&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#tilt">&lt;tilt&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#timeprimitive">&lt;TimePrimitive&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#timespan">&lt;TimeSpan&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#gxtimespan">&lt;gx:TimeSpan&gt;</a><span class="new50"> New</span></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#timestamp">&lt;TimeStamp&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#gxtimestamp">&lt;gx:TimeStamp&gt;</a><span class="new50"> New</span></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#topfov">&lt;topFov&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#gxtour">&lt;gx:Tour&gt;</a><span class="new50"> New</span></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#gxtourcontrol">&lt;gx:TourControl&gt;</a><span class="new50"> New</span></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#gxtourprimitive">&lt;gx:TourPrimitive&gt;</a><span class="new50"> New</span></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#update">&lt;Update&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#url">&lt;Url&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#value">&lt;value&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#viewboundscale">&lt;viewBoundScale&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#viewformat">&lt;viewFormat&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#viewrefreshmode">&lt;viewRefreshMode&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#viewrefreshtime">&lt;viewRefreshTime&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#viewvolume">&lt;ViewVolume&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#visibility">&lt;visibility&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#gxwait">&lt;gx:Wait&gt;</a><span class="new50"> New</span></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#west">&lt;west&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#when">&lt;when&gt;</a></li>
      <li><a href="http://code.google.com/apis/kml/documentation/kmlreference.html#width">&lt;width&gt;</a></li>
      </ul>
    </li>
  </ul>
</li>
</ul>

<div class="line"></div>
<ul class="treelist tlw-nested-only tlw-processed tlw-instance-2">
<li><h2 class="tlw-ignore">More Resources</h2>
  <ul>
    <li><a href="http://code.google.com/apis/kml/documentation/mediagallery.html">Media Gallery</a></li>
  </ul>
</li>
</ul>

      </div>
      
      <a name="gc-pagecontent-anchor"></a>   

      <div style="position: relative;" class="g-unit skip-collapsible" id="gc-pagecontent">
        <h1 class="page_title">KML Reference</h1>


<p>This section contains an alphabetical reference for all KML elements defined in KML Version 2.2, as well as elements in the <a href="#kmlextensions">Google extension namespace</a>. The class tree for KML elements is shown below. In this diagram, elements to the right on a particular branch in the tree are <em>extensions</em> of the elements to their left. For example, Placemark is a special kind of <em>Feature</em>. It contains all of the elements that belong to <em>Feature</em>, and it adds some elements that are specific to the Placemark element.</p>
<p>KML is an open standard officially named the OpenGIS® KML Encoding
Standard (OGC KML). It is maintained by the Open Geospatial Consortium,
Inc. (OGC). The complete specification for OGC KML can be found at <a href="http://www.opengeospatial.org/standards/kml/">http://www.opengeospatial.org/standards/kml/</a>.</p>
<p>The complete XML schema for KML is located at <a href="http://schemas.opengis.net/kml/">http://schemas.opengis.net/kml/</a>.</p>
<p class="note"><b>Note:</b> Click an element name in this diagram to jump to its entry in the reference section. </p>
    
<img src="kmlreference22_ext-Dateien/hierarchy_withgx.gif" alt="kml object hierarchy showing inheritance among objects" usemap="#Map" border="0">
<map name="Map" id="Map">
<area shape="rect" coords="9,50,103,97" href="#object">
<area shape="rect" coords="203,41,279,55" href="#networklink" title="Network Link">
<area shape="rect" coords="203,58,283,72" href="#placemark" title="Placemark">
<area shape="rect" coords="79,110,174,138" href="#feature" title="Feature">
<area shape="rect" coords="203,80,299,109" href="#overlay" title="Overlay">
<area shape="rect" coords="324,59,407,77" href="#photooverlay" title="Photo Overlay">
<area shape="rect" coords="204,122,298,150" href="#container" title="Container">
<area shape="rect" coords="321,78,409,92" href="#screenoverlay" title="Screen Overlay">
<area shape="rect" coords="324,95,416,111" href="#groundoverlay" title="Ground Overlay">
<area shape="rect" coords="81,153,174,180" href="#geometry" title="Geometry">
<area shape="rect" coords="322,120,401,139" href="#folder" title="Folder">
<area shape="rect" coords="323,138,389,155" href="#document" title="Document">
<area shape="rect" coords="230,168,276,183" href="#point" title="point">
<area shape="rect" coords="235,465,311,479" href="#balloonstyle" title="Balloon Style">
<area shape="rect" coords="226,185,299,204" href="#linestring" title="Line String">
<area shape="rect" coords="235,483,301,498" href="#liststyle" title="list style">
<area shape="rect" coords="77,196,105,210" href="#link" title="link">
<area shape="rect" coords="147,195,179,211" href="#icon" title="icon">
<area shape="rect" coords="223,206,296,222" href="#linearring" title="linear ring">
<area shape="rect" coords="229,224,285,240" href="#polygon" title="polygon">
<area shape="rect" coords="75,212,149,229" href="#orientation" title="orientation">
<area shape="rect" coords="228,242,323,261" href="#multigeometry" title="multi geometry">
<area shape="rect" coords="76,233,130,248" href="#location" title="location">
<area shape="rect" coords="233,262,282,277" href="#model" title="model">
<area shape="rect" coords="76,251,117,269" href="#scale" title="scale">
<area shape="rect" coords="238,507,336,535" href="#colorstyle" title="color style">
<area shape="rect" coords="82,274,181,303" href="#styleselector" title="style selector">
<area shape="rect" coords="381,468,446,485" href="#linestyle" title="line style">
<area shape="rect" coords="384,487,449,502" href="#polystyle" title="poly style">
<area shape="rect" coords="382,506,448,521" href="#iconstyle" title="icon style">
<area shape="rect" coords="384,523,449,540" href="#labelstyle" title="label style">
<area shape="rect" coords="238,283,277,299" href="#style" title="style">
<area shape="rect" coords="237,302,297,320" href="#stylemap" title="style map">
<area shape="rect" coords="82,314,182,343" href="#timeprimitive" title="time primitive">
<area shape="rect" coords="82,354,181,382" href="#abstractview" title="abstract view">
<area shape="rect" coords="237,323,296,337" href="#timespan" title="time span">
<area shape="rect" coords="239,340,304,357" href="#timestamp" title="time stamp">
<area shape="rect" coords="237,359,297,378" href="#camera" title="camera">
<area shape="rect" coords="236,377,297,397" href="#lookat" title="look at">
<area shape="rect" coords="80,389,136,407" href="#region" title="region">
<area shape="rect" coords="80,414,116,429" href="#lod" title="L O D">
<area shape="rect" coords="80,430,148,452" href="#latlonbox" title="lat lon box">
<area shape="rect" coords="80,452,155,469" href="#latlonaltbox" title="lat lon alt box">
<area shape="rect" coords="78,473,167,492" href="#gxlatlonquad">
<area shape="rect" coords="83,539,182,569" href="#gxtourprimitive">
<area shape="rect" coords="161,590,278,608" href="#gxanimatedupdate">
<area shape="rect" coords="162,612,216,627" href="#gxflyto">
<area shape="rect" coords="162,629,242,645" href="#gxsoundcue">
<area shape="rect" coords="164,649,248,665" href="#gxtourcontrol">
<area shape="rect" coords="162,667,211,684" href="#gxwait">
<area shape="rect" coords="76,685,143,704" href="#gxplaylist">
<area shape="rect" coords="201,18,249,40" href="#gxtour">
<area shape="rect" coords="300,322,378,338" href="#gxtimespan">
<area shape="rect" coords="307,341,393,359" href="#gxtimestamp">
</map>

<p>Note that abstract elements (shown in boxes in the diagram) are not
actually used in KML files. They are a useful way for a single element
to serve as the programmatic foundation for multiple similar (but
different) derived elements. Understanding this object-oriented
hierarchy is also a good way for you to learn KML, since you can easily
see groupings of related elements.</p>
<p>All elements derived from <em>Object</em> can have an <strong>id</strong> assigned to them. This <strong>id</strong> is used by the KML update mechanism (see <a href="#update">&lt;Update&gt;</a>) for files loaded with a NetworkLink. It is also used by shared styles (see <a href="#style">&lt;Style&gt;</a>). The <strong>id</strong> is a standard <a href="http://www.w3.org/TR/xmlschema11-2/#ID">XML ID</a>. </p>
<p>Because KML is an XML grammar and file format, tag names are
case-sensitive and must appear exactly as shown here. If you're
familiar with XML, you will also be interested in the <a href="http://schemas.opengis.net/kml/">KML 2.2 Schema</a>. When you are editing KML text files, you can load this Schema into any XML editor and validate your KML code with it. </p>

<p><strong>Tip: Viewing KML for Google Earth Features</strong> </p>
<p>Here is a handy feature of Google Earth that makes it easy to view
the KML file for any Feature. In Google Earth, you can right-click a
Feature in the Places panel and copy it. To view the corresponding KML
for the copied object, open your favorite text editor and paste the
selection into it. </p>
<p><strong>Compatibility</strong></p>
<p><span>KML versions have a double numbering system:  <code><em>majorVersion.minorVersion</em></code>. All versions with the same <code>majorVersion</code> are compatible. For this reason, if you change the namespace to "2.2" (that is, <code>xmlns="http://www.opengis.net/kml/2.2"</code>), all KML 2.1 files validate in the <a href="http://schemas.opengis.net/kml/">KML 2.2 schema</a>.</span></p>

<h2>About this reference</h2>
<p>Each reference entry includes a Syntax section that lists the
elements contained in the main element. This Syntax section is an
informal listing and uses simple shorthand to summarize the elements.
This section also contains the following:</p>
<ul>
  <li><em>default values</em> for each element (or ellipses if it is a complex element or if there is no default value)</li>
  <li>the <em>type</em> of the value (see  <a href="#kmlfields">KML Fields</a>) </li>
</ul>
<p>The Syntax section can be copied and used as a template for any non-abstract element in a KML file. </p>

<h2><a name="kmlextensions"></a>KML Extension Namespace and the gx prefix</h2>
<p>The <a href="http://www.opengeospatial.org/standards/kml/">OGC KML standard</a> provides a mechanism for extensions - additional elements that contain information beyond what is available in the standard (<a href="http://www.w3.org/TR/REC-xml-names/">learn more about XML namespaces</a>
at w3.org). With the launch of Google Earth 5.0, Google has provided
extensions to KML to support a number of new features. These extensions
use the <strong>gx</strong> prefix and the following namespace URI:</p>
<p>&nbsp;<code>xmlns:gx="http://www.google.com/kml/ext/2.2"</code></p>
<p>This namespace URI must be added to the <code>&lt;kml&gt;</code> element in any KML file using <strong>gx-</strong>prefixed elements:</p>
<pre>&lt;kml xmlns="http://www.opengis.net/kml/2.2"
 <strong>xmlns:gx="http://www.google.com/kml/ext/2.2</strong>"&gt;</pre>
<p>Extensions to KML may not be supported in all geo-browsers. If your
browser doesn't support particular extensions, the data in those
extensions should be silently ignored, and the rest of the KML file
should load without errors.</p>
<p>Elements included in the <strong>gx</strong> prefix are:</p>
<ul>
  <li><a href="#gxaltitudemode">gx:altitudeMode</a></li>
  <li><a href="#gxanimatedupdate">gx:AnimatedUpdate</a></li>
  <li><a href="#gxballoonvisibility">gx:balloonVisibility</a></li>
  <li><a href="#gxduration">gx:duration</a></li>
  <li><a href="#gxflyto">gx:FlyTo</a></li>
  <li><a href="#gxflytomode">gx:flyToMode</a></li>
  <li><a href="#gxlatlonquad">gx:LatLonQuad</a></li>
  <li><a href="#gxplaylist">gx:Playlist</a></li>
  <li><a href="#gxtourcontrol">gx:playMode</a></li>
  <li><a href="#gxsoundcue">gx:SoundCue</a></li>
	<li><a href="#gxtimespan">gx:TimeSpan</a></li>
	<li><a href="#gxtimestamp">gx:TimeStamp</a></li>
  <li><a href="#gxtour">gx:Tour</a></li>
  <li><a href="#gxtourcontrol">gx:TourControl</a></li>
  <li><a href="#gxtourprimitive">gx:TourPrimitive</a></li>
  <li><a href="#gxwait">gx:Wait</a></li>
</ul>
<p>The complete XML schema for elements in this extension namespace is located at <a href="http://code.google.com/apis/kml/schema/kml22gx.xsd">http://code.google.com/apis/kml/schema/kml22gx.xsd</a>.</p>
<h2><a name="kmlfields" id="kmlfields"></a>KML fields</h2>
<p>KML uses common XML types such as <em>boolean, string, double, float,</em> and <em>int</em>.
In addition, it defines a number of field element types. The following
table lists some of the most commonly used types defined in KML and
links to sample elements that use them:</p>
     <table summary="" cellpadding="0" cellspacing="0">
        <tbody><tr>
				  <th scope="col"><em><strong>Field Type</strong></em></th>
          <th scope="col"><em><strong>Value</strong></em></th>
		      <th scope="col"><em><strong>Example Use</strong></em></th> 
        </tr>
				<tr>
          <td><strong>altitudeModeEnum</strong></td>
          <td>clampToGround, relativeToGround, absolute </td>
          <td>See <a href="#lookat">&lt;LookAt&gt;</a> and <a href="#region">&lt;Region&gt;</a> </td>
        </tr>
        <tr>
          <td><strong>angle90</strong></td>
          <td>a value ≥−90 and ≤90</td>
          <td>See <a href="#latitude">&lt;latitude&gt;</a> in &lt;Model&gt; </td>
        </tr>
				<tr>
          <td><strong>anglepos90</strong></td>
          <td>a value ≥0 and ≤90 </td>
		      <td>See <a href="#tilt">&lt;tilt&gt;</a> in &lt;LookAt&gt; </td>
        </tr>
        <tr>
          <td><strong>angle180</strong></td>
          <td>a value ≥−180 and ≤180</td>
          <td>See <a href="#longitude">&lt;longitude&gt;</a> in &lt;Model&gt; </td>
        </tr>
        <tr>
          <td><strong>angle360</strong></td>
          <td>a value ≥−360 and ≤360</td>
          <td>See &lt;heading&gt;, &lt;tilt&gt;, and &lt;roll&gt; in<br>
            <a href="#orientation">&lt;Orientation&gt;</a> </td>
        </tr>
        
        <tr>
          <td><strong>color</strong></td>
          <td>hexBinary value:<em> aabbggrr</em> </td>
          <td>See any element that extends <a href="#colorstyle"><em>&lt;ColorStyle&gt;</em></a> </td>
        </tr>
        
        <tr>
          <td><strong>colorModeEnum</strong></td>
          <td> normal, random </td>
          <td>See any element that extends <a href="#colorstyle"><em>&lt;ColorStyle&gt;</em></a> </td>
        </tr>
				<tr>
          <td><strong>dateTime</strong></td>
          <td><em> dateTime, date, gYearMonth, gYear</em></td>
          <td>See <a href="#timespan">&lt;TimeSpan&gt;</a> and <a href="#timestamp">&lt;TimeStamp&gt; </a></td>
        </tr>
				<tr>
          <td><span><strong>displayModeEnum</strong></span></td>
          <td><span>default, hide </span></td>
          <td><span>See <a href="#balloonstyle">&lt;BalloonStyle&gt;</a> </span></td>
        </tr>
				<tr>
          <td><span><strong>gridOrigin</strong></span></td>
          <td><span>lowerLeft, upperLeft</span></td>
          <td><span>See <a href="#photooverlay">&lt;PhotoOverlay&gt;</a></span> </td>
        </tr>
          
        <tr>
          <td><strong>refreshModeEnum</strong></td>
          <td>onChange, onInterval, onExpire </td>
          <td>See <a href="#link">&lt;Link&gt;</a> </td>
        </tr>
				<tr>
	        <td><span><strong>shapeEnum</strong></span></td>
	        <td><span>rectangle, cylinder, sphere</span></td>
          <td><span>See <a href="#photooverlay">&lt;PhotoOverlay&gt;</a></span></td>
	      </tr>
		    <tr>
				  <td><strong>styleStateEnum</strong></td>
		      <td>normal, highlight</td>
		      <td>See <a href="#stylemap">&lt;StyleMap&gt;</a></td>
		    </tr>
        <tr>
          <td><strong>unitsEnum</strong></td>
          <td> fraction, pixels, insetPixels </td>
          <td>See <a href="#hotspot">&lt;hotSpot&gt;</a> in &lt;IconStyle&gt;, <a href="#screenoverlay">&lt;ScreenOverlay&gt;</a></td>
        </tr>
				<tr>
          <td><strong>vec2</strong></td>
          <td>x=<em>double</em> xunits=<em>kml:unitsEnum</em><br> 
          y=<em>double</em> yunits=<em>kml:unitsEnum</em></td>
          <td>See <a href="#hotspot">&lt;hotSpot&gt;</a> in &lt;IconStyle&gt;, <br>
            <a href="#screenoverlay">&lt;ScreenOverlay&gt;</a> </td>
        </tr>
        <tr>
          <td><strong>viewRefreshEnum</strong></td>
          <td>never, onRequest, onStop, onRegion </td>
          <td>See <a href="#link">&lt;Link&gt;</a> </td>
        </tr>
				
	</tbody></table>
	

<h2>&nbsp;</h2>

<h2><a name="abstractview" id="abstractview" class="anchor"></a>&lt;AbstractView&gt;</h2>
<h3>Syntax </h3>
 <pre>&lt;!-- abstract element; do not create --&gt;
<strong>&lt;!--<em> AbstractView</em> --&gt;</strong>                   &lt;!-- Camera, LookAt --&gt;                
  &lt;!-- extends <span class="style1">Object</span> --&gt;
  <em>&lt;TimePrimitive&gt;...&lt;/TimePrimitive&gt;</em>                        &lt;!-- gx:TimeSpan or gx:TimeStamp --&gt;
<strong>&lt;-- /<em>AbstractView</em> --&gt;</strong></pre>

<h3>Description </h3>
<p>This is an abstract element and cannot be used directly in a KML file. This element is extended by the <a href="#camera">&lt;Camera&gt;</a> and <a href="#lookat">&lt;LookAt&gt;</a> elements. </p>
<h3>Extends</h3>
<ul>
  <li><a href="#object">&lt;Object&gt;</a></li>
</ul>
<h3>Extended By</h3>
    <ul>
      <li><a href="#camera">&lt;Camera&gt;</a></li>
      <li><a href="#lookat">&lt;LookAt&gt;</a></li>
    </ul>

    
<h2><a name="gxaltitudemode"></a>&lt;gx:altitudeMode&gt;</h2>
<table class="note" width="60%">
<tbody><tr><td class="note">This element is an extension of the <a href="http://www.opengeospatial.org/standards/kml/">OGC KML 2.2 standard</a> and is supported in Google Earth 5.0. <a href="#kmlextensions">Learn more</a></td></tr></tbody></table>
<h3>Syntax</h3>
<pre>&lt;gx:altitudeMode&gt;clampToGround&lt;/gx:altitudeMode&gt;    
  &lt;!-- gx:altitudeModeEnum: <em>relativeToSeaFloor, clampToSeaFloor</em>, <em>relativeToGround</em>, <em>clampToGround</em>, <em>absolute</em> --&gt;</pre>
<h3>Description</h3>
<p>Can be used instead of the OGC KML standard <code>&lt;altitudeMode&gt;</code> element, and accepts the following values in addition to the standard altitudeMode values:</p>
<ul>
  <li> <strong>relativeToSeaFloor</strong> - Interprets the
altitude as a value in meters above the sea floor. If the KML feature
is above land rather than sea, the altitude will be interpreted as
being above the ground.</li>
  <li><strong>clampToSeaFloor</strong> -
The altitude specification is ignored, and the KML feature will be
positioned on the sea floor. If the KML feature is on land rather than
at sea, <strong>clampToSeaFloor</strong> will instead clamp to ground.</li>
</ul>
<p>As with <code>&lt;altitudeMode&gt;</code>, <code>&lt;gx:altitudeMode&gt;</code> affects:</p>
<ul>
  <li> the altitude coordinate within the <code>&lt;coordinates&gt;</code> element</li>
  <li><code>&lt;minAltitude&gt;</code> and <code>&lt;maxAltitude&gt;</code> within <code>&lt;LatLonAltBox&gt;</code></li>
  <li><code>&lt;altitude&gt;</code> within <code>&lt;Location&gt;</code>, <code>&lt;GroundOverlay&gt;</code>, and <code>AbstractView</code> (<code>&lt;LookAt&gt;</code> and <code>&lt;Camera&gt;</code>).</li>
</ul>
<p>More information about altitude modes is available in the <a href="http://code.google.com/apis/kml/documentation/altitudemode.html">Altitude Modes</a> chapter of the <strong>KML Developer's Guide</strong>.

</p><h3>Example</h3>

<p><img src="kmlreference22_ext-Dateien/kml_feed_small.png" alt="" height="16" width="16">&nbsp;<a href="http://code.google.com/apis/kml/documentation/kmlfiles/altitudemode_reference.kml">altitudemode_reference.kml</a></p>

<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2"&gt;   &lt;!-- required when using gx-prefixed elements --&gt;

&lt;Placemark&gt;
  &lt;name&gt;gx:altitudeMode Example&lt;/name&gt;
  &lt;LookAt&gt;
    &lt;longitude&gt;146.806&lt;/longitude&gt;
    &lt;latitude&gt;12.219&lt;/latitude&gt;
    &lt;heading&gt;-60&lt;/heading&gt;
    &lt;tilt&gt;70&lt;/tilt&gt;
    &lt;range&gt;6300&lt;/range&gt;
    <strong>&lt;gx:altitudeMode&gt;relativeToSeaFloor&lt;/gx:altitudeMode&gt;</strong>
  &lt;/LookAt&gt;
  &lt;LineString&gt;
    &lt;extrude&gt;1&lt;/extrude&gt;
    &lt;gx:altitudeMode&gt;relativeToSeaFloor&lt;/gx:altitudeMode&gt;
    &lt;coordinates&gt;
      146.825,12.233,400
      146.820,12.222,400
      146.812,12.212,400
      146.796,12.209,400
      146.788,12.205,400
    &lt;/coordinates&gt;
  &lt;/LineString&gt;
&lt;/Placemark&gt;

&lt;/kml&gt;
</pre>

<p>&nbsp;</p>
	
<h2><a name="gxanimatedupdate"></a>&lt;gx:AnimatedUpdate&gt;</h2>

<table class="note" width="60%">
<tbody><tr><td class="note">This element is an extension of the <a href="http://www.opengeospatial.org/standards/kml/">OGC KML 2.2 standard</a> and is supported in Google Earth 5.0. <a href="#kmlextensions">Learn more</a></td></tr></tbody></table>

<h3>Syntax</h3>
<pre>&lt;gx:AnimatedUpdate&gt;
  &lt;gx:duration&gt;0.0&lt;/gx:duration&gt;    &lt;!-- double, specifies time in seconds --&gt;
  &lt;Update&gt;
    &lt;targetHref&gt;...&lt;/targetHref&gt;    &lt;!-- required; can contain a URL or be left blank --&gt;
                                                &lt;!-- (to target elements within the same file --&gt;
    &lt;Change&gt;...&lt;/Change&gt;
    &lt;Create&gt;...&lt;/Create&gt;
    &lt;Delete&gt;...&lt;/Delete&gt;
  &lt;/Update&gt;
&lt;/gx:AnimatedUpdate&gt;</pre>
<h3>Description </h3>
<p><code>&lt;gx:AnimatedUpdate&gt;</code> controls changes during a tour to KML features, using <code><a href="#update">&lt;Update&gt;</a></code>.
Changes to KML features will not modify the DOM - that is, any changes
will be reverted when the tour is over, and will not be saved in the
KML at any time.</p>
<p><code>&lt;gx:AnimatedUpdate&gt;</code> should also contain a <code>&lt;gx:duration&gt;</code>
value to specify the length of time in seconds over which the update
takes place. Integer, float, and color fields are smoothly animated
from original to new value across the duration; boolean, string, and
other values that don't lend to interpolation are updated at the end of
the duration.</p>
<p>Refer to <a href="http://code.google.com/apis/kml/documentation/touring.html#tourtimelines">Tour timelines</a> in the <strong>Touring</strong> chapter of the <strong>KML Developer's Guide</strong> for information about <code>&lt;gx:AnimatedUpdate&gt;</code> and the tour timeline.</p>
<h3>Example</h3>
<p>The example below demonstrates a change in icon size. This change will be animated over a 5 second duration.</p>
<p><img src="kmlreference22_ext-Dateien/kml_feed_small.png" alt="" height="16" width="16">&nbsp;<a href="http://code.google.com/apis/kml/documentation/kmlfiles/animatedupdate_example.kml">animatedupdate_example.kml</a></p>
<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2"&gt;

&lt;Document&gt;
  &lt;name&gt;gx:AnimatedUpdate example&lt;/name&gt;

  &lt;Style id="pushpin"&gt;
    &lt;IconStyle id="mystyle"&gt;<br>      &lt;Icon&gt;<br>        &lt;href&gt;http://maps.google.com/mapfiles/kml/pushpin/ylw-pushpin.png&lt;/href&gt;
        &lt;scale&gt;1.0&lt;/scale&gt;<br>      &lt;/Icon&gt;<br>    &lt;/IconStyle&gt;<br>  &lt;/Style&gt;

  &lt;Placemark id="mountainpin1"&gt;
    &lt;name&gt;Pin on a mountaintop&lt;/name&gt;
    &lt;styleUrl&gt;#pushpin&lt;/styleUrl&gt;<br>    &lt;Point&gt;<br>      &lt;coordinates&gt;170.1435558771009,-43.60505741890396,0&lt;/coordinates&gt;<br>    &lt;/Point&gt;
  &lt;/Placemark&gt;

  &lt;gx:Tour&gt;
    &lt;name&gt;Play me!&lt;/name&gt;

    &lt;gx:Playlist&gt;

      &lt;gx:FlyTo&gt;<br>        &lt;gx:flyToMode&gt;bounce&lt;/gx:flyToMode&gt;<br>        &lt;gx:duration&gt;3&lt;/gx:duration&gt;<br>        &lt;Camera&gt;<br>          &lt;longitude&gt;170.157&lt;/longitude&gt;<br>          &lt;latitude&gt;-43.671&lt;/latitude&gt;<br>          &lt;altitude&gt;9700&lt;/altitude&gt;<br>          &lt;heading&gt;-6.333&lt;/heading&gt;<br>          &lt;tilt&gt;33.5&lt;/tilt&gt;<br>        &lt;/Camera&gt;<br>      &lt;/gx:FlyTo&gt;

      <strong>&lt;gx:AnimatedUpdate&gt;
        &lt;gx:duration&gt;5&lt;/gx:duration&gt;
        &lt;Update&gt;
          &lt;targetHref&gt;&lt;/targetHref&gt;
          &lt;Change&gt;
            &lt;IconStyle targetId="mystyle"&gt;
              &lt;scale&gt;10.0&lt;/scale&gt;
            &lt;/IconStyle&gt;
          &lt;/Change&gt;
        &lt;/Update&gt;
      &lt;/gx:AnimatedUpdate&gt;</strong>

      &lt;gx:Wait&gt;
        &lt;gx:duration&gt;5&lt;/gx:duration&gt;
      &lt;/gx:Wait&gt;

    &lt;/gx:Playlist&gt;
  &lt;/gx:Tour&gt;

&lt;/Document&gt;
&lt;/kml&gt;</pre>
<h3>Extends</h3>
<ul>
  <li><a href="#gxabstracttourprimitive">&lt;gx:TourPrimitive&gt;</a></li>
</ul>
<h3>Contains</h3>
<ul>
  <li><a href="#gxduration">&lt;gx:duration&gt;</a></li>
  <li><a href="#update">&lt;Update&gt;</a></li>
</ul>

<h2><a name="balloonstyle"></a>&lt;BalloonStyle&gt;</h2>
<h3>Syntax</h3>
    <pre><strong>&lt;BalloonStyle id="ID"&gt;</strong>
  &lt;!-- specific to BalloonStyle --&gt;
  &lt;bgColor&gt;ffffffff&lt;/bgColor&gt;            &lt;!-- kml:color --&gt;
  &lt;textColor&gt;ff000000&lt;/textColor&gt;        &lt;!-- kml:color --&gt; 
  &lt;text&gt;<em>...</em>&lt;/text&gt;                       &lt;!-- string --&gt;
  <span>&lt;displayMode&gt;default&lt;/displayMode&gt;<strong>     </strong>&lt;!-- kml:displayModeEnum --&gt;</span><strong>
&lt;/BalloonStyle&gt;</strong></pre>

    <h3>Description </h3>
<p>Specifies how the description balloon for placemarks is drawn. The
&lt;bgColor&gt;, if specified, is used as the background color of the
balloon. See <a href="#feature">&lt;<em>Feature</em>&gt;</a> for a diagram illustrating how the default description balloon appears in Google Earth. </p>
    
<h3>Elements Specific to BalloonStyle</h3>
	<dl>
      <dt><strong>&lt;bgColor&gt; </strong><a name="bgcolor" id="bgcolor"></a></dt>
      <dd>Background
color of the balloon (optional). Color and opacity (alpha) values are
expressed in hexadecimal notation. The range of values for any one
color is 0 to 255 (<span class="code">00</span> to <span class="code">ff</span>). The order of expression is <em>aabbggrr, </em>where <em>aa=alpha</em> (00 to ff); <em>bb=blue</em> (00 to ff); <em>gg=green </em>(00 to ff); <em>rr=red</em> (00 to ff). For alpha, <span class="code">00</span> is fully transparent and <span class="code">ff</span>
is fully opaque. For example, if you want to apply a blue color with 50
percent opacity to an overlay, you would specify the following: <span class="code">&lt;bgColor&gt;7fff0000&lt;/bgColor&gt;</span>, where <em>alpha</em>=0x7f, <em>blue</em>=0xff, <em>green</em>=0x00, and <em>red</em>=0x00. The default is opaque white (ffffffff). </dd>
      
      <p class="note"><strong>Note:</strong>  The use of the &lt;color&gt; element within &lt;BalloonStyle&gt; has been deprecated.  Use &lt;bgColor&gt; instead.</p>
     
  <dt><strong>&lt;textColor&gt; <a name="textcolor" id="textcolor"></a></strong></dt>
  <dd>Foreground color for text. The default is black (ff000000). </dd>
	<dt><strong>&lt;text&gt;<a name="text" id="text"></a></strong></dt>
	<dd>Text displayed in the balloon. If no text is specified, <span>Google
Earth draws the default balloon (with the Feature &lt;name&gt; in
boldface, the Feature &lt;description&gt;, links for driving
directions, a white background, and a tail that is attached to the
point coordinates of the Feature, if specified). </span></dd>
	<dd> You can add entities to the &lt;text&gt; tag using the following format to refer to a child element of Feature: <strong>$[name]</strong>, <strong>$[description]</strong>, <strong>$[address]</strong>, <strong>$[id]</strong>, <strong>$[Snippet]</strong>.
Google Earth looks in the current Feature for the corresponding string
entity and substitutes that information in the balloon. To include <em>To</em> <em>here - From here </em> driving directions in the balloon, use the <strong>$[geDirections]</strong> tag. <span>To
prevent the driving directions links from appearing in a balloon,
include the &lt;text&gt; element with some content, or with
$[description] to substitute the basic Feature &lt;description&gt;.</span> </dd>
	
	<dd>For example, in the following KML excerpt, <strong>$[name]</strong> and <strong>$[description]</strong>
fields will be replaced by the &lt;name&gt; and &lt;description&gt;
fields found in the Feature elements that use this BalloonStyle: <pre>&lt;text&gt;This is $[name], whose description is:&lt;br/&gt;$[description]&lt;/text&gt;</pre>
	</dd>
	
	<dt><span><strong>&lt;displayMode&gt;<a name="displaymode" id="displaymode"></a></strong></span></dt>
	<dd><span>If &lt;displayMode&gt; is <em>default</em>, Google Earth uses the information supplied in &lt;text&gt; to create a balloon . If &lt;displayMode&gt; is <em>hide</em>, Google Earth does not display the balloon.</span> In Google Earth, clicking the List View icon for a Placemark whose balloon's &lt;displayMode&gt; is <em>hide</em> causes Google Earth to fly to the Placemark. </dd>
	</dl>
	
<h3>Example</h3>
	<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>&lt;kml xmlns="http://www.opengis.net/kml/2.2"&gt;<br>&lt;Document&gt;
  &lt;name&gt;BalloonStyle.kml&lt;/name&gt;<br>  &lt;open&gt;1&lt;/open&gt;<br>  &lt;Style id="exampleBalloonStyle"&gt;<br>    <strong>&lt;BalloonStyle&gt;</strong><br>      &lt;!-- a background color for the balloon --&gt;<br>      &lt;bgColor&gt;ffffffbb&lt;/bgColor&gt;<br>      &lt;!-- styling of the balloon text --&gt;<br>      &lt;text&gt;&lt;![CDATA[<br>      &lt;b&gt;&lt;font color="#CC0000" size="+3"&gt;$[name]&lt;/font&gt;&lt;/b&gt;<br>      &lt;br/&gt;&lt;br/&gt;<br>      &lt;font face="Courier"&gt;$[description]&lt;/font&gt;<br>      &lt;br/&gt;&lt;br/&gt;<br>      Extra text that will appear in the description balloon<br>      &lt;br/&gt;&lt;br/&gt;<br>      &lt;!-- insert the to/from hyperlinks --&gt;<br>      $[geDirections]<br>      ]]&gt;&lt;/text&gt;<br>    <strong>&lt;/BalloonStyle&gt;</strong><br>  &lt;/Style&gt;<br>  &lt;Placemark&gt;<br>    &lt;name&gt;BalloonStyle&lt;/name&gt;<br>    &lt;description&gt;An example of BalloonStyle&lt;/description&gt;<br>    &lt;styleUrl&gt;#exampleBalloonStyle&lt;/styleUrl&gt;<br>    &lt;Point&gt;<br>      &lt;coordinates&gt;-122.370533,37.823842,0&lt;/coordinates&gt;<br>    &lt;/Point&gt;<br>  &lt;/Placemark&gt;<br>&lt;/Document&gt;<br>&lt;/kml&gt;</pre>
	
<h3>Extends</h3>
<ul>
	<li><a href="#colorstyle">&lt;<em>ColorStyle</em>&gt;</a></li>
</ul>
       
<h3>Contained By </h3> 
<ul> 
  <li><a href="#style">&lt;Style&gt;</a></li> 
</ul>
<p class="backtotop"><a href="#top">Back to top</a></p>
		
<h2><a name="gxballoonvisibility"></a>&lt;gx:balloonVisibility&gt;</h2>

<table class="note" width="60%">
<tbody><tr><td class="note">This element is an extension of the <a href="http://www.opengeospatial.org/standards/kml/">OGC KML 2.2 standard</a> and is supported in Google Earth 5.0. <a href="#kmlextensions">Learn more</a></td></tr></tbody></table>

<h3>Syntax</h3>
<pre>&lt;gx:balloonVisibility&gt;0&lt;/gx:balloonVisibility&gt;    &lt;!-- <em>0 </em>(not visible) or <em>1 </em>(visible) --&gt;</pre>

<h3>Description</h3>
<p>Toggles visibility of a description balloon. The balloon to be updated must be identified by the object's XML ID (e.g. <code>&lt;Placemark targetId="xxx"&gt;</code>).</p>
<h3>Examples</h3>
<p>The first example shows <code>&lt;gx:balloonVisibility&gt;</code> with a Placemark. When the placemark is loaded, the description balloon is opened.<br>
<img src="kmlreference22_ext-Dateien/kml_feed_small.png" alt="" height="16" width="16">&nbsp;<a href="http://code.google.com/apis/kml/documentation/kmlfiles/balloonvisibility_example.kml">balloonvisibility_example.kml</a></p>
<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2"&gt;
  
  &lt;Placemark&gt;
    &lt;name&gt;Eiffel Tower&lt;/name&gt;
    &lt;description&gt;
        Located in Paris, France. <br>        <br>        This description balloon opens <br>        when the Placemark is loaded.
    &lt;/description&gt;
    &lt;gx:balloonVisibility&gt;1&lt;/gx:balloonVisibility&gt;
    &lt;Point&gt;
      &lt;coordinates&gt;2.294785,48.858093,0&lt;/coordinates&gt;
    &lt;/Point&gt;
  &lt;/Placemark&gt;

&lt;/kml&gt;</pre>

<p>The second example shows the use of <code>&lt;gx:balloonVisibility&gt;</code> within a tour. A number of balloons are opened and closed during the tour, providing information to the viewer.<br> 
<img src="kmlreference22_ext-Dateien/kml_feed_small.png" alt="" height="16" width="16">&nbsp;<a href="http://code.google.com/apis/kml/documentation/kmlfiles/balloonvisibility_tourexample.kml">balloonvisibility_tourexample.kml</a></p>
<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>&lt;kml xmlns="http://www.opengis.net/kml/2.2"<br> xmlns:gx="http://www.google.com/kml/ext/2.2"&gt;<br>  <br>  &lt;Document&gt;<br>    &lt;name&gt;balloonVisibility Example&lt;/name&gt;<br>    &lt;open&gt;1&lt;/open&gt;<br>    <br>    &lt;gx:Tour&gt;<br>      &lt;name&gt;Play me&lt;/name&gt;<br>      &lt;gx:Playlist&gt;<br>        <br>        &lt;gx:FlyTo&gt;<br>          &lt;gx:duration&gt;8.0&lt;/gx:duration&gt;<br>          &lt;gx:flyToMode&gt;bounce&lt;/gx:flyToMode&gt;<br>          &lt;LookAt&gt;<br>            &lt;longitude&gt;-119.748584&lt;/longitude&gt;<br>            &lt;latitude&gt;33.736266&lt;/latitude&gt;<br>            &lt;altitude&gt;0&lt;/altitude&gt;<br>            &lt;heading&gt;-9.295926&lt;/heading&gt;
            &lt;tilt&gt;84.0957450&lt;/tilt&gt;
            &lt;range&gt;4469.850414&lt;/range&gt;<br>            &lt;gx:altitudeMode&gt;relativeToSeaFloor&lt;/gx:altitudeMode&gt;<br>          &lt;/LookAt&gt;
        &lt;/gx:FlyTo&gt;<br>        <br>        &lt;gx:AnimatedUpdate&gt;<br>          &lt;gx:duration&gt;0.0&lt;/gx:duration&gt;<br>          &lt;Update&gt;<br>            &lt;targetHref/&gt;<br>            &lt;Change&gt;<br>              &lt;Placemark targetId="underwater1"&gt;<br>                &lt;gx:balloonVisibility&gt;1&lt;/gx:balloonVisibility&gt;<br>              &lt;/Placemark&gt;<br>            &lt;/Change&gt;<br>          &lt;/Update&gt;<br>        &lt;/gx:AnimatedUpdate&gt;<br>        <br>        &lt;gx:Wait&gt;<br>          &lt;gx:duration&gt;4.0&lt;/gx:duration&gt;<br>        &lt;/gx:Wait&gt;

        &lt;gx:AnimatedUpdate&gt;<br>          &lt;gx:duration&gt;0.0&lt;/gx:duration&gt;<br>          &lt;Update&gt;<br>            &lt;targetHref/&gt;<br>            &lt;Change&gt;<br>              &lt;Placemark targetId="underwater1"&gt;<br>                &lt;gx:balloonVisibility&gt;0&lt;/gx:balloonVisibility&gt;<br>              &lt;/Placemark&gt;<br>            &lt;/Change&gt;<br>          &lt;/Update&gt;<br>        &lt;/gx:AnimatedUpdate&gt;<br>        <br>        &lt;gx:FlyTo&gt;<br>          &lt;gx:duration&gt;3&lt;/gx:duration&gt;<br>          &lt;gx:flyToMode&gt;smooth&lt;/gx:flyToMode&gt;<br>          &lt;LookAt&gt;<br>            &lt;longitude&gt;-119.782630&lt;/longitude&gt;<br>            &lt;latitude&gt;33.862855&lt;/latitude&gt;<br>            &lt;altitude&gt;0&lt;/altitude&gt;<br>            &lt;heading&gt;-9.314858&lt;/heading&gt;
            &lt;tilt&gt;84.117317&lt;/tilt&gt;
            &lt;range&gt;6792.665540&lt;/range&gt;<br>            &lt;gx:altitudeMode&gt;relativeToSeaFloor&lt;/gx:altitudeMode&gt;<br>          &lt;/LookAt&gt;<br>        &lt;/gx:FlyTo&gt;<br>        <br>        &lt;gx:AnimatedUpdate&gt;<br>          &lt;gx:duration&gt;0.0&lt;/gx:duration&gt;<br>          &lt;Update&gt;<br>            &lt;targetHref/&gt;<br>            &lt;Change&gt;<br>              &lt;Placemark targetId="underwater2"&gt;<br>                &lt;gx:balloonVisibility&gt;1&lt;/gx:balloonVisibility&gt;<br>              &lt;/Placemark&gt;<br>            &lt;/Change&gt;<br>          &lt;/Update&gt;<br>        &lt;/gx:AnimatedUpdate&gt;<br>        <br>        &lt;gx:Wait&gt;<br>          &lt;gx:duration&gt;4.0&lt;/gx:duration&gt;<br>        &lt;/gx:Wait&gt;

        &lt;gx:AnimatedUpdate&gt;<br>          &lt;gx:duration&gt;0.0&lt;/gx:duration&gt;<br>          &lt;Update&gt;<br>            &lt;targetHref/&gt;<br>            &lt;Change&gt;<br>              &lt;Placemark targetId="underwater2"&gt;<br>                &lt;gx:balloonVisibility&gt;0&lt;/gx:balloonVisibility&gt;<br>              &lt;/Placemark&gt;<br>            &lt;/Change&gt;<br>          &lt;/Update&gt;<br>        &lt;/gx:AnimatedUpdate&gt;<br>        <br>        &lt;gx:FlyTo&gt;<br>          &lt;gx:duration&gt;3&lt;/gx:duration&gt;<br>          &lt;gx:flyToMode&gt;smooth&lt;/gx:flyToMode&gt;<br>          &lt;LookAt&gt;<br>            &lt;longitude&gt;-119.849578&lt;/longitude&gt;<br>            &lt;latitude&gt;33.968515&lt;/latitude&gt;<br>            &lt;altitude&gt;0&lt;/altitude&gt;<br>            &lt;heading&gt;-173.948935&lt;/heading&gt;
            &lt;tilt&gt;23.063392&lt;/tilt&gt;
            &lt;range&gt;3733.666023&lt;/range&gt;<br>            &lt;altitudeMode&gt;relativeToGround&lt;/altitudeMode&gt;<br>          &lt;/LookAt&gt;<br>        &lt;/gx:FlyTo&gt;<br>        <br>        &lt;gx:AnimatedUpdate&gt;<br>          &lt;gx:duration&gt;0.0&lt;/gx:duration&gt;<br>          &lt;Update&gt;<br>            &lt;targetHref/&gt;<br>            &lt;Change&gt;<br>              &lt;Placemark targetId="onland"&gt;<br>                &lt;gx:balloonVisibility&gt;1&lt;/gx:balloonVisibility&gt;<br>              &lt;/Placemark&gt;<br>            &lt;/Change&gt;<br>          &lt;/Update&gt;<br>        &lt;/gx:AnimatedUpdate&gt;<br>        <br>        &lt;gx:Wait&gt;<br>          &lt;gx:duration&gt;4.0&lt;/gx:duration&gt;<br>        &lt;/gx:Wait&gt;<br>        <br>      &lt;/gx:Playlist&gt;<br>    &lt;/gx:Tour&gt;<br>    <br>    &lt;Placemark id="underwater1"&gt;<br>      &lt;name&gt;Underwater off the California Coast&lt;/name&gt;<br>      &lt;description&gt;
        The tour begins near the Santa Cruz Canyon, 
        off the coast of California, USA.
      &lt;/description&gt;<br>      &lt;Point&gt;<br>        &lt;gx:altitudeMode&gt;clampToSeaFloor&lt;/gx:altitudeMode&gt;<br>        &lt;coordinates&gt;-119.749531,33.715059,0&lt;/coordinates&gt;<br>      &lt;/Point&gt;<br>    &lt;/Placemark&gt;<br>    <br>    &lt;Placemark id="underwater2"&gt;<br>      &lt;name&gt;Still swimming...&lt;/name&gt;<br>      &lt;description&gt;We're about to leave the ocean, and visit the coast...&lt;/description&gt;<br>      &lt;Point&gt;<br>        &lt;gx:altitudeMode&gt;clampToSeaFloor&lt;/gx:altitudeMode&gt;<br>        &lt;coordinates&gt;-119.779550,33.829268,0&lt;/coordinates&gt;<br>      &lt;/Point&gt;<br>    &lt;/Placemark&gt;<br>    <br>    &lt;Placemark id="onland"&gt;<br>      &lt;name&gt;The end&lt;/name&gt;<br>      &lt;description&gt;
        &lt;![CDATA[The end of our simple tour. 
        Use &lt;gx:balloonVisibility&gt;1&lt;/gx:balloonVisibility&gt; 
        to show description balloons.]]&gt;
      &lt;/description&gt;<br>      &lt;Point&gt;<br>        &lt;coordinates&gt;-119.849578,33.968515,0&lt;/coordinates&gt;<br>      &lt;/Point&gt;<br>    &lt;/Placemark&gt;<br>    <br>    <br>  &lt;/Document&gt;<br>&lt;/kml&gt;</pre>

<h3>Extends</h3>
<ul>
  <li><a href="#feature">&lt;Feature&gt;</a></li>
</ul>

<h2><span><a name="camera" id="camera" class="anchor"></a>&lt;Camera&gt;</span></h2>
<h3>Syntax </h3> 
	<pre><strong>&lt;Camera id="ID"&gt;</strong>
  &lt;!-- inherited from AbstractView element --&gt;
  <em>&lt;TimePrimitive&gt;...&lt;/TimePrimitive&gt;</em>  &lt;!-- gx:TimeSpan or gx:TimeStamp --&gt;
   
  &lt;!-- specific to Camera --&gt;
  &lt;longitude&gt;0&lt;/longitude&gt;            &lt;!-- kml:angle180 --&gt; 
  &lt;latitude&gt;0&lt;/latitude&gt;              &lt;!-- kml:angle90 --&gt;
  &lt;altitude&gt;0&lt;/altitude&gt;              &lt;!-- double --&gt;
  &lt;heading&gt;0&lt;/heading&gt;                &lt;!-- kml:angle360 --&gt;
  &lt;tilt&gt;0&lt;/tilt&gt;                      &lt;!-- kml:anglepos180 --&gt;
  &lt;roll&gt;0&lt;/roll&gt;                      &lt;!-- kml:angle180 --&gt;
  &lt;altitudeMode&gt;clampToGround&lt;/altitudeMode&gt;              
        &lt;!-- kml:altitudeModeEnum: relativeToGround, clampToGround, or absolute --&gt;
        &lt;!-- or, gx:altitudeMode can be substituted: clampToSeaFloor, relativeToSeaFloor --&gt;
<strong>&lt;/Camera&gt;</strong> </pre>
	
<h3>Description</h3>
<p>Defines the virtual camera that views the scene. This element defines the <span class="style1">position</span> of the camera relative to the Earth's surface as well as the <em>viewing direction</em> of the camera. The camera <em>position</em>
is defined by &lt;longitude&gt;, &lt;latitude&gt;, &lt;altitude&gt;,
and either &lt;altitudeMode&gt; or &lt;gx:altitudeMode&gt;. The <em>viewing direction </em>
of the camera is defined by &lt;heading&gt;, &lt;tilt&gt;, and
&lt;roll&gt;. &lt;Camera&gt; can be a child element of any Feature or
of &lt;NetworkLinkControl&gt;. A parent element cannot contain both a
&lt;Camera&gt; and a &lt;LookAt&gt; at the same time.</p>
	
	<p>&lt;Camera&gt;
provides full six-degrees-of-freedom control over the view, so you can
position the Camera in space and then rotate it around the <em>X</em>, <em>Y</em>, and <em>Z</em> axes. Most importantly, you can tilt the camera view so that you're looking above the horizon into the sky. </p>
	
	<p>&lt;Camera&gt;
can also contain a TimePrimitive (&lt;gx:TimeSpan&gt; or
&lt;gx:TimeStamp&gt;). Time values in Camera affect historical imagery,
sunlight, and the display of time-stamped features. For more
information, read <a href="http://code.google.com/apis/kml/documentation/time.html#abstractviews">Time with AbstractViews</a> in the <strong>Time and Animation</strong> chapter of the Developer's Guide.</p>
	
	<h4>Defining a View</h4>
	<p>
Within a Feature or &lt;NetworkLinkControl&gt;, use either a
&lt;Camera&gt; or a &lt;LookAt&gt; object (but not both in the same
object). The &lt;Camera&gt; object defines the viewpoint in terms of
the viewer's position and orientation. The &lt;Camera&gt; object allows
you to specify a view that is not on the Earth's surface. The
&lt;LookAt&gt; object defines the viewpoint in terms of what is being
viewed. The &lt;LookAt&gt; object is more limited in scope than
&lt;Camera&gt; and generally requires that the view direction intersect
the Earth's surface. </p>
	<p>The following diagram shows the <em>X</em>, <em>Y</em>, and <em>Z</em> axes, which are attached to the virtual camera. </p>
	<ul>
	  <li>The <em>X</em> axis points toward the right of the camera and is called the <em>right vector</em>. </li>
    <li>The <em>Y</em> axis defines the "up" direction relative to the screen and is called the <em>up vector</em>.</li>
    <li>The <em>Z</em> axis points from the center of the screen toward the eye point. The camera looks down the <em>−Z</em> axis, which is called the <em>view vector</em>. </li>
</ul>
	
	
	<p><img src="kmlreference22_ext-Dateien/defaultCameraAxes.gif" alt="" height="284" width="295"></p>
	<h3>Order of Transformations </h3>  
  <p>The
order of rotation is important. By default, the camera is looking
straight down the −Z axis toward the Earth. Before rotations are
performed, the camera is translated along the <em>Z</em> axis to &lt;altitude&gt;. The order of transformations is as follows:</p>
  <ol>
    <li><strong>&lt;altitude&gt;</strong> - translate along the <em>Z</em> axis to &lt;altitude&gt;  </li>
	  <li><strong>&lt;heading&gt;</strong> - rotate around the <em>Z</em> axis. </li>
	  <li><strong>&lt;tilt&gt;</strong> - rotate around the <em>X</em> axis. </li>
	  <li><strong>&lt;roll&gt;</strong> - rotate around the <em>Z</em> axis (again). </li>
</ol>
	<p>Note that each time a rotation is applied, two of the camera axes change their orientation. </p>
	
  <h3>Elements Specific to Camera </h3>
	<dl>
	<dt><strong>&lt;longitude&gt;</strong></dt>
	<dd>Longitude
of the virtual camera (eye point). Angular distance in degrees,
relative to the Prime Meridian. Values west of the Meridian range from
−180 to 0 degrees. Values east of the Meridian range from 0 to 180
degrees.</dd>
	<dt><strong>&lt;latitude&gt;</strong> </dt>
	<dd>Latitude of the virtual camera. Degrees north or south of the Equator (0 degrees). Values range from −90 degrees to 90 degrees.</dd>
	<dt><strong>&lt;altitude&gt;</strong></dt>
	<dd>Distance
of the camera from the earth's surface, in meters. Interpreted
according to the Camera's &lt;altitudeMode&gt; or
&lt;gx:altitudeMode&gt;.</dd>
	<dt><strong>&lt;heading&gt;<a name="heading" id="heading"></a></strong></dt>
	<dd>Direction (azimuth) of the camera, in degrees. Default=0 (true North). (<a href="#headingdiagram">See diagram</a>.) Values range from 0 to 360 degrees. </dd>
	<dt><strong>&lt;tilt&gt;<a name="tilt" id="tilt"></a></strong></dt>
	<dd>Rotation, in degrees, of the camera around the <em>X</em>
axis. A value of 0 indicates that the view is aimed straight down
toward the earth (the most common case). A value for 90 for
&lt;tilt&gt; indicates that the view is aimed toward the horizon.
Values greater than 90 indicate that the view is pointed up into the
sky. Values for &lt;tilt&gt; are clamped at +180 degrees. </dd>
	<dt><strong>&lt;roll&gt;<a name="tilt" id="tilt"></a></strong></dt>
	<dd>Rotation, in degrees, of the camera around the <span class="style1">Z</span> axis. Values range from −180 to +180 degrees. </dd>
	<dt><strong>&lt;altitudeMode&gt;</strong></dt>
	<dd>Specifies how the &lt;altitude&gt; specified for the Camera  is interpreted. Possible values are as follows:
        <ul>
          <li><strong>relativeToGround</strong>
- (default) Interprets the &lt;altitude&gt; as a value in meters above
the ground. If the point is over water, the &lt;altitude&gt; will be
interpreted as a value in meters above sea level. See <a href="#gxaltitudemode">&lt;gx:altitudeMode&gt;</a> below to specify points relative to the sea floor.</li>
          <li><strong>clampToGround </strong>- Indicates to ignore the &lt;altitude&gt; specification and place the Camera position on the ground.</li>
          <li><strong>absolute </strong>- Interprets the &lt;altitude&gt; as a value in meters above sea level. </li>
        </ul>
    </dd>
	<dt><a name="gxaltitudemode"></a>&lt;gx:altitudeMode&gt;</dt>
	<dd>A KML extension in the <a href="#kmlextensions">Google extension namespace</a>, allowing altitudes relative to the sea floor. Values are:
	  <ul>
	    <li><strong>relativeToSeaFloor</strong>
- Interprets the &lt;altitude&gt; as a value in meters above the sea
floor. If the point is above land rather than sea, the &lt;altitude&gt;
will be interpreted as being above the ground.</li>
        <li><strong>clampToSeaFloor</strong>
- The &lt;altitude&gt; specification is ignored, and the Camera will be
positioned on the sea floor. If the point is on land rather than at
sea, the Camera will be positioned on the ground.</li>
	  </ul>
	</dd>
</dl> 
	
<h3>Extends</h3>
<ul>
<li><a href="#abstractview">&lt;<em>AbstractView</em>&gt;</a></li>
</ul>

<h3>Contained By</h3>
<ul>
<li>Any element derived from <a href="#feature">&lt;<em>Feature</em>&gt;</a></li>
<li><a href="#networklinkcontrol">&lt;NetworkLinkControl&gt;</a></li>
</ul>
<p class="backtotop"><a href="#top">Back to top</a></p>

<a name="colorstyle"></a>

<h2>&lt;<em>ColorStyle</em>&gt;</h2><h3>Syntax </h3> 
<pre>&lt;!-- abstract element; do not create --&gt;
<strong>&lt;!<em>-- ColorStyle</em> id="ID" --&gt;</strong>          &lt;!-- IconStyle,LabelStyle,LineStyle,PolyStyle --&gt;
  &lt;color&gt;ffffffff&lt;/color&gt;            &lt;!-- kml:color --&gt;
  &lt;colorMode&gt;normal&lt;/colorMode&gt;      &lt;!-- kml:colorModeEnum: normal <em>or</em> random --&gt;
<strong>&lt;!-- /<em>ColorStyle</em> --&gt;</strong></pre>

<h3>Description</h3>
<p>This is an abstract element and cannot be used directly in a KML
file. It provides elements for specifying the color and color mode of
extended style types.</p>
<h3>Elements Specific to ColorStyle</h3>
<dl>
	   <dt><strong>&lt;color&gt;</strong><a name="color" id="color"></a></dt>
	   <dd>Color and opacity (alpha) values are expressed in hexadecimal notation. The range of values for any one color is 0 to 255 (<span class="code">00</span> to <span class="code">ff</span>). For alpha, <span class="code">00</span> is fully transparent and <span class="code">ff</span> is fully opaque. The order of expression is <em>aabbggrr, </em>where <em>aa=alpha</em> (00 to ff); <em>bb=blue</em> (00 to ff); <em>gg=green </em>(00 to ff); <em>rr=red</em>
(00 to ff). For example, if you want to apply a blue color with 50
percent opacity to an overlay, you would specify the following: <span class="code">&lt;color&gt;7fff0000&lt;/color&gt;</span>, where <em>alpha</em>=0x7f, <em>blue</em>=0xff, <em>green</em>=0x00, and <em>red</em>=0x00.</dd>
	   <dt><strong>&lt;colorMode&gt;</strong><a name="colormode" id="colormode"></a> </dt>
	   <dd>Values for &lt;colorMode&gt; are <strong>normal</strong> (no effect) and <strong>random</strong>. A value of <strong>random</strong> applies a random linear scale to the base &lt;color&gt; as follows. </dd>
</dl>
	
	 <ul>
	   <li>To achieve a truly random selection of colors, specify a base &lt;color&gt; of white (00ffffff). </li>
	   <li>If you specify a single color component (for example, a value of ff0000ff for <em>red</em>), random color values for that one component (red) will be selected. In this case, the values would range from 00 (<em>black</em>) to ff (<em>full red</em>). </li>
	   <li>If
you specify values for two or for all three color components, a random
linear scale is applied to each color component, with results ranging
from black to the maximum values specified for each component.</li>
	   <li>The opacity of a color comes from the alpha component of &lt;color&gt; and is never randomized. </li>
	 </ul>
	 
	 <h3>Extends</h3>
	<ul>
	  <li><a href="#object">&lt;<em>Object</em>&gt;</a></li>
</ul>

<h3>Extended By </h3>
	<ul>
	  
	  <li><a href="#iconstyle">&lt;IconStyle&gt;</a></li>
	  <li><a href="#labelstyle">&lt;LabelStyle&gt;</a></li>
	  <li><a href="#linestyle">&lt;LineStyle&gt;</a></li>
	 
	  <li>&lt;<a href="#polystyle">PolyStyle</a>&gt;</li>
	</ul>
<p class="backtotop"><a href="#top">Back to top</a></p>
	
<a name="container"></a>
<h2>&lt;<em>Container</em>&gt;</h2>
<h3>Syntax </h3> 
	<pre>&lt;!-- abstract element; do not create --&gt;
<strong>&lt;!-- <em>Container</em> id="ID" --&gt;</strong>              &lt;!-- Document,Folder --&gt;                 
  &lt;!-- inherited from <em>Feature</em> element --&gt;
  &lt;name&gt;<em>...</em>&lt;/name&gt;                      &lt;!-- string --&gt;
  &lt;visibility&gt;1&lt;/visibility&gt;            &lt;!-- boolean --&gt;
  &lt;open&gt;0&lt;/open&gt;                        &lt;!-- boolean --&gt;
  &lt;address&gt;<em>...</em>&lt;/address&gt;                &lt;!-- string --&gt;
  &lt;AddressDetails xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"&gt;...<br>      &lt;/AddressDetails&gt;                 &lt;!-- string --&gt;
  &lt;phoneNumber&gt;...&lt;/phoneNumber&gt;        &lt;!-- string --&gt;<br>  &lt;Snippet maxLines="2"&gt;<em>...</em>&lt;/Snippet&gt;   &lt;!-- string --&gt;
  &lt;description&gt;<em>...</em>&lt;/description&gt;        &lt;!-- string --&gt;
  <span><em>&lt;AbstractView&gt;...&lt;/AbstractView&gt;</em>      &lt;!-- LookAt <em>or</em> Camera --&gt;</span>
  &lt;<em>TimePrimitive</em>&gt;...&lt;/<em>TimePrimitive</em>&gt;
  &lt;styleUrl&gt;<em>...</em>&lt;/styleUrl&gt;              &lt;!-- anyURI --&gt;
  &lt;<em>StyleSelector&gt;...&lt;/StyleSelector&gt;</em>
  &lt;Region&gt;...&lt;/Region&gt;
  &lt;Metadata&gt;...&lt;/Metadata&gt;
  <span>&lt;atom:author&gt;...&lt;atom:author&gt;   &lt;!-- xmlns:atom="http://www.w3.org/2005/Atom" --&gt;
  &lt;atom:link&gt;...&lt;/atom:link&gt;</span>

  &lt;!-- specific to <em>Container</em> --&gt; <br>  &lt;!-- 0 or more Features --&gt; 
<strong>&lt;!-- /<em>Container --</em>&gt;</strong></pre>
	 <h3>Description</h3>
	 <p>This
is an abstract element and cannot be used directly in a KML file. A
Container element holds one or more Features and allows the creation of
nested hierarchies. </p>
	
<h3>Extends</h3>
<ul>
	 <li><a href="#feature">&lt;<em>Feature</em>&gt;</a></li>
</ul>
<h3>Extended By </h3>
	<ul>
	  <li><a href="#document">&lt;Document&gt;</a></li>
	  <li><a href="#folder">&lt;Folder&gt;</a></li>
	</ul>
<p class="backtotop"><a href="#top">Back to top</a></p>
	
<a name="document" id="document" class="anchor"></a>
<h2>&lt;Document&gt;</h2>
<h3>Syntax </h3>
    <pre><strong>&lt;Document id="ID"&gt;</strong>
  &lt;!-- inherited from <em>Feature</em> element --&gt;
  &lt;name&gt;<em>...</em>&lt;/name&gt;                      &lt;!-- string --&gt;
  &lt;visibility&gt;1&lt;/visibility&gt;            &lt;!-- boolean --&gt;
  &lt;open&gt;0&lt;/open&gt;                        &lt;!-- boolean --&gt;
  <span>&lt;atom:author&gt;...&lt;atom:author&gt;         &lt;!-- xmlns:atom --&gt;
  &lt;atom:link&gt;...&lt;/atom:link&gt;</span><span>            &lt;!-- xmlns:atom --&gt;</span>
  &lt;address&gt;<em>...</em>&lt;/address&gt;                &lt;!-- string --&gt;
  &lt;xal:AddressDetails&gt;...&lt;/xal:AddressDetails&gt;  &lt;!-- xmlns:xal --&gt;<br>  &lt;phoneNumber&gt;...&lt;/phoneNumber&gt;        &lt;!-- string --&gt;<br>  &lt;Snippet maxLines="2"&gt;<em>...</em>&lt;/Snippet&gt;   &lt;!-- string --&gt;
  &lt;description&gt;<em>...</em>&lt;/description&gt;        &lt;!-- string --&gt;
  <span><em>&lt;AbstractView&gt;...&lt;/AbstractView&gt;</em>      &lt;!-- Camera <em>or</em> LookAt --&gt;</span>
  &lt;<em>TimePrimitive</em>&gt;...&lt;/<em>TimePrimitive</em>&gt;
  &lt;styleUrl&gt;<em>...</em>&lt;/styleUrl&gt;              &lt;!-- anyURI --&gt;
  &lt;<em>StyleSelector&gt;...&lt;/StyleSelector&gt;</em>
  &lt;Region&gt;...&lt;/Region&gt;
  <span>&lt;Metadata&gt;...&lt;/Metadata&gt;              &lt;!-- deprecated in KML 2.2 --&gt;
  &lt;ExtendedData&gt;...&lt;/ExtendedData&gt;      &lt;!-- new in KML 2.2 --&gt;</span>

  &lt;!-- specific to Document --&gt;
  &lt;!-- 0 or more Schema elements --&gt;
  &lt;!-- 0 or more <em>Feature</em> elements --&gt;
<strong>&lt;/Document&gt;</strong></pre>

    <h3>Description </h3>
<p>A Document is a container for features and styles. <span>This element is required if your KML file uses <em>shared styles</em>. It is recommended that you use shared styles, which require the following steps:</span></p>
<ol><span>
  <li>Define all Styles in a Document. Assign a unique <strong>ID</strong> to each Style.</li>
  <li>Within a given Feature or StyleMap, reference the Style's ID using a &lt;styleUrl&gt; element. </li></span>
</ol>
<p><span>Note that shared styles are not inherited by the Features in the Document. </span></p>
<p><span>Each Feature must explicitly reference the styles it uses in a
&lt;styleUrl&gt; element. For a Style that applies to a Document (such
as ListStyle), the Document itself must explicitly reference the
&lt;styleUrl&gt;. For example:</span></p>
<pre>&lt;Document&gt;
  &lt;Style id="myPrettyDocument"&gt;
   &lt;ListStyle&gt; ... &lt;/ListStyle&gt;

  &lt;/Style&gt;
  &lt;styleUrl#myPrettyDocument"&gt;
  ...
&lt;/Document&gt; </pre>
<p><span>Do not put shared styles within a Folder. </span></p>
<p><span>The following example illustrates use of a shared style.</span> </p>
<h3>Example</h3>
     <pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>&lt;kml xmlns="http://www.opengis.net/kml/2.2"&gt;<br><strong>&lt;Document&gt;</strong><br>  &lt;name&gt;Document.kml&lt;/name&gt;<br>  &lt;open&gt;1&lt;/open&gt;
  &lt;Style id="exampleStyleDocument"&gt;<br>    &lt;LabelStyle&gt;<br>      &lt;color&gt;ff0000cc&lt;/color&gt;<br>    &lt;/LabelStyle&gt;<br>  &lt;/Style&gt;<br>  &lt;Placemark&gt;<br>    &lt;name&gt;Document Feature 1&lt;/name&gt;<br>    &lt;styleUrl&gt;#exampleStyleDocument&lt;/styleUrl&gt;<br>    &lt;Point&gt;<br>      &lt;coordinates&gt;-122.371,37.816,0&lt;/coordinates&gt;<br>    &lt;/Point&gt;<br>  &lt;/Placemark&gt;<br>  &lt;Placemark&gt;<br>    &lt;name&gt;Document Feature 2&lt;/name&gt;<br>    &lt;styleUrl&gt;#exampleStyleDocument&lt;/styleUrl&gt;<br>    &lt;Point&gt;<br>      &lt;coordinates&gt;-122.370,37.817,0&lt;/coordinates&gt;<br>    &lt;/Point&gt;<br>  &lt;/Placemark&gt;<br><strong>&lt;/Document&gt;</strong><br>&lt;/kml&gt;</pre> 

<h3>Extends</h3>
<ul>
	  <li><a href="#container">&lt;<em>Container</em>&gt;</a></li>
</ul>
       
<h3>Contains </h3> 
    <ul>
      <li>0 or more elements derived from <a href="#feature">&lt;<em>Feature</em>&gt;</a></li>
      <li>0 or more elements derived from <a href="#styleselector">&lt;<em>StyleSelector</em>&gt;</a></li>
      <li>0 or more elements derived from <a href="#schema">&lt;Schema&gt;</a> </li>
    </ul>
<p class="backtotop"><a href="#top">Back to top</a></p>

<h2><a name="gxduration"></a>&lt;gx:duration&gt;</h2>

<table class="note" width="60%">
<tbody><tr><td class="note">This element is an extension of the <a href="http://www.opengeospatial.org/standards/kml/">OGC KML 2.2 standard</a> and is supported in Google Earth 5.0. <a href="#kmlextensions">Learn more</a></td></tr></tbody></table>

<h3>Syntax</h3>
<pre>&lt;gx:duration&gt;0.0&lt;/gx:duration&gt;            &lt;!-- double --&gt;
</pre>

<h3>Description</h3>
<p><code>&lt;gx:duration&gt;</code> extends <code>gx:TourPrimitive</code> by specifying a time-span for events. The time is written as seconds using XML's <a href="#tbd">double</a> datatype.</p>
<h4>Duration and &lt;gx:FlyTo&gt;</h4>
<p>When a duration is included within a <code>&lt;gx:FlyTo&gt;</code> element, it specifies the length of time that the browser  takes to fly from the previous point to the specified point. </p>
<pre>&lt;gx:FlyTo&gt;
  &lt;gx:flyToMode&gt;bounce&lt;/gx:flyToMode&gt;
  <strong>&lt;gx:duration&gt;10.2&lt;/gx:duration&gt;</strong>

  &lt;!-- AbstractView --&gt;
    ...
  &lt;!-- /AbstractView --&gt;
&lt;/gx:FlyTo&gt;</pre>

<br>

<h4>Duration and &lt;gx:AnimatedUpdate&gt;</h4>
<p>Specifies the length of time over which the update takes place.
Integer, float, and color fields are smoothly animated from original to
new value across the duration; boolean, string, and other values that
don't lend to interpolation are updated at the end of the duration.</p>
<pre>&lt;gx:AnimatedUpdate&gt;
  <strong>&lt;gx:duration&gt;5.0&lt;/gx:duration&gt;</strong>
  &lt;Update&gt;

    ....

  &lt;/Update&gt;
&lt;/gx:AnimatedUpdate&gt;</pre>

<p>&nbsp;</p>

<h2><span><a name="extendeddata" id="extendeddata" class="anchor"></a>&lt;ExtendedData&gt;</span></h2>
<h3>Syntax </h3>
<pre>&lt;ExtendedData&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br>  &lt;Data name="string"&gt;<br>&nbsp;   &lt;displayName&gt;...&lt;/displayName&gt;&nbsp;&nbsp;&nbsp; &lt;!-- string --&gt;<br> &nbsp;&nbsp; &lt;value&gt;...&lt;/value&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;!-- string --&gt;<br>  &lt;/Data&gt;
  &lt;SchemaData schemaUrl="<em>anyURI</em>"&gt;<br>    &lt;SimpleData name=""&gt; ... &lt;/SimpleData&gt;&nbsp;&nbsp; &lt;!-- string --&gt;<br>  &lt;/SchemaData&gt;
  &lt;namespace_prefix:other&gt;...&lt;/namespace_prefix:other&gt;
&lt;/ExtendedData&gt;</pre>

<h3>Description</h3>
<p>The ExtendedData element offers three techniques for adding custom
data to a KML Feature (NetworkLink, Placemark, GroundOverlay,
PhotoOverlay, ScreenOverlay, Document, Folder). These techniques are</p>
<ul>
  <li>Adding untyped data/value pairs using the &lt;Data&gt; element (basic)</li>
  <li>Declaring
new typed fields using the &lt;Schema&gt; element and then instancing
them using the &lt;SchemaData&gt; element (advanced) </li>
  <li>Referring to XML elements defined in other namespaces by referencing the external namespace within the KML file (basic) </li>
</ul>
<p>These techniques can be combined within a single KML file or Feature for different pieces of data. </p>
<p>For more information, see <a href="http://code.google.com/intl/de/apis/kml/documentation/extendeddata.html">Adding Custom Data</a> in "Topics in KML." </p>
<h3>Elements Specific to ExtendedData</h3>
<dl>
<dt>&lt;Data name ="<em>string</em>"&gt;<a name="data" id="data"></a></dt>
<dd>Creates an untyped <em>name/value</em> pair. The name can have two versions: <em>name</em> and <em>displayName</em>. The <em>name</em> attribute is used to identify the data pair within the KML file. The <em>displayName</em>
element is used when a properly formatted name, with spaces and HTML
formatting, is displayed in Google Earth. In the &lt;text&gt; element
of &lt;BalloonStyle&gt;, the notation<strong> $[name:displayName]</strong> is replaced with &lt;displayName&gt;. If you substitute the value of the <em>name</em>
attribute of the &lt;Data&gt; element in this format (for example,
$[holeYardage], the attribute value is replaced with &lt;value&gt;. By
default, the Placemark's balloon displays the name/value pairs
associated with it. </dd>
<dd>
  <dl>
  <dt>&lt;displayName&gt;<a name="displayname" id="displayname"></a></dt>
  <dd>An optional formatted version of <em>name</em>, to be used for display purposes. </dd>
  <dt>&lt;value&gt;<a name="value" id="value"></a></dt>
  <dd>Value of the data pair. </dd>
	<dd>
  <pre>&lt;Placemark&gt;
  &lt;name&gt;Club house&lt;/name&gt;
  &lt;ExtendedData&gt;
    &lt;Data name="holeNumber"&gt;
      &lt;value&gt;1&lt;/value&gt;
    &lt;/Data&gt;
    &lt;Data name="holeYardage"&gt;
      &lt;value&gt;234&lt;/value&gt;
    &lt;/Data&gt;
    &lt;Data name="holePar"&gt;
      &lt;value&gt;4&lt;/value&gt;
    &lt;/Data&gt;
  &lt;/ExtendedData&gt;
&lt;/Placemark&gt;</pre>
	</dd>
  </dl>
</dd>
<dt>&lt;SchemaData schemaUrl="<em>anyURI</em>"&gt;<a name="schemadata" id="schemadata"></a></dt>
<dd>This element is used in conjunction with &lt;Schema&gt; to add
typed custom data to a KML Feature. The Schema element (identified by
the <em>schemaUrl</em> attribute) declares the custom data type. The
actual data objects ("instances" of the custom data) are defined using
the SchemaData element. </dd>
<dd>The &lt;schemaURL&gt; can be a full URL, a reference to a Schema ID
defined in an external KML file, or a reference to a Schema ID defined
in the same KML file. All of the following specifications are
acceptable:</dd>

<pre>schemaUrl="http://host.com/PlacesIHaveLived.kml#my-schema-id"</pre>
<pre>schemaUrl="AnotherFile.kml#my-schema-id"</pre>
<pre>schemaUrl="#schema-id"   &lt;!-- same file --&gt;</pre>
<dd>The Schema element is always a child of Document. The ExtendedData
element is a child of the Feature that contains the custom data. </dd>
<dd>
<dl>
<dt>&lt;SimpleData name="<em>string</em>"&gt;<a name="simpledata" id="simpledata"></a></dt>
<dd>This element assigns a value to the custom data field identified by the <em>name</em> attribute. The type and name of this custom data field are declared in the &lt;Schema&gt; element. </dd>
<dd>Here is an example of defining two custom data elements:</dd>
<pre>&lt;Placemark&gt;
  &lt;name&gt;Easy trail&lt;/name&gt;
  &lt;ExtendedData&gt;
    &lt;SchemaData schemaUrl="#TrailHeadTypeId"&gt;
      &lt;SimpleData name="TrailHeadName"&gt;Pi in the sky&lt;/SimpleData&gt;
      &lt;SimpleData name="TrailLength"&gt;3.14159&lt;/SimpleData&gt;
      &lt;SimpleData name="ElevationGain"&gt;10&lt;/SimpleData&gt;
    &lt;/SchemaData&gt;
    &lt;/ExtendedData&gt;
    &lt;Point&gt;
      &lt;coordinates&gt;-122.000,37.002&lt;/coordinates&gt;
    &lt;/Point&gt;
&lt;/Placemark&gt;
&lt;Placemark&gt;
  &lt;name&gt;Difficult trail&lt;/name&gt;
  &lt;ExtendedData&gt;
    &lt;SchemaData schemaUrl="#TrailHeadTypeId"&gt;
      &lt;SimpleData name="TrailHeadName"&gt;Mount Everest&lt;/SimpleData&gt;
      &lt;SimpleData name="TrailLength"&gt;347.45&lt;/SimpleData&gt;
      &lt;SimpleData name="ElevationGain"&gt;10000&lt;/SimpleData&gt;
    &lt;/SchemaData&gt;
  &lt;/ExtendedData&gt;
  &lt;Point&gt;
    &lt;coordinates&gt;-122.000,37.002&lt;/coordinates&gt;
  &lt;/Point&gt;
&lt;/Placemark&gt;</pre>
</dl>
</dd>
</dl>

<dl>
<dt>&lt;<em>namespace_prefix:other&gt;</em></dt>
<dd>This element allows you to add untyped custom data. Be sure to
reference the namespace prefix in the &lt;kml&gt; element of your file
or as an attribute of the &lt;ExtendedData&gt; element and to prefix
the name of each data element with the namespace prefix. Custom data
added in this manner is preserved in the KML file but is not used by
Google Earth in any way. It is always saved along with the file. </dd>
<dd>The following example shows using the "camp" namespace prefix:</dd>
<pre>&lt;ExtendedData xmlns:prefix="camp"&gt;<br>  &lt;camp:number&gt;14&lt;/camp:number&gt;<br>  &lt;camp:parkingSpaces&gt;2&lt;/camp:parkingSpaces&gt;<br>  &lt;camp:tentSites&gt;4&lt;/camp:tentSites&gt;<br>&lt;/ExtendedData&gt;
</pre>
</dl>

<h3>Contained By</h3>
<ul>
<li>Any element derived from <a href="#feature">&lt;<em>Feature</em>&gt;</a></li>
</ul>

<h3>See Also</h3>
<ul>
<li><a href="#schema">Schema</a></li>
</ul>
    
<a name="feature"></a>
<h2>&lt;<em>Feature</em>&gt;</h2>
<h3>Syntax </h3>
<pre>&lt;!-- abstract element; do not create --&gt;
<strong>&lt;!--<em> Feature</em> id="ID" --&gt;</strong>                &lt;!-- Document,Folder,
                                             NetworkLink,Placemark,
                                             GroundOverlay,PhotoOverlay,ScreenOverlay --&gt;
  &lt;name&gt;<em>...</em>&lt;/name&gt;                      &lt;!-- string --&gt;
  &lt;visibility&gt;1&lt;/visibility&gt;            &lt;!-- boolean --&gt;
  &lt;open&gt;0&lt;/open&gt;                        &lt;!-- boolean --&gt;
  <span>&lt;atom:author&gt;...&lt;atom:author&gt;         &lt;!-- xmlns:atom --&gt;
  &lt;atom:link&gt;...&lt;/atom:link&gt;</span><span>            &lt;!-- xmlns:atom --&gt;</span>
  &lt;address&gt;<em>...</em>&lt;/address&gt;                &lt;!-- string --&gt;
  &lt;xal:AddressDetails&gt;...&lt;/xal:AddressDetails&gt;  &lt;!-- xmlns:xal --&gt;<br>  &lt;phoneNumber&gt;...&lt;/phoneNumber&gt;        &lt;!-- string --&gt;<br>  &lt;Snippet maxLines="2"&gt;<em>...</em>&lt;/Snippet&gt;   &lt;!-- string --&gt;
  &lt;description&gt;<em>...</em>&lt;/description&gt;        &lt;!-- string --&gt;
  <span><em>&lt;AbstractView&gt;...&lt;/AbstractView&gt;</em>      &lt;!-- Camera <em>or</em> LookAt --&gt;</span>
  &lt;<em>TimePrimitive</em>&gt;...&lt;/<em>TimePrimitive</em>&gt;    &lt;!-- TimeStamp or TimeSpan --&gt;
  &lt;styleUrl&gt;<em>...</em>&lt;/styleUrl&gt;              &lt;!-- anyURI --&gt;
  &lt;<em>StyleSelector&gt;...&lt;/StyleSelector&gt;</em>
  &lt;Region&gt;...&lt;/Region&gt;
  <span>&lt;Metadata&gt;...&lt;/Metadata&gt;              &lt;!-- deprecated in KML 2.2 --&gt;
  &lt;ExtendedData&gt;...&lt;/ExtendedData&gt;      &lt;!-- new in KML 2.2 --&gt;<br></span>&lt;-- /<em>Feature</em> --&gt;</pre>
	
  <h3>Description</h3>
	
<p>This is an abstract element and cannot be used directly in a KML
file. The following diagram shows how some of a Feature's elements
appear in Google Earth. </p>
<img src="kmlreference22_ext-Dateien/ScreenLabels.gif" alt="" height="391" width="578">

<h3>Elements Specific to Feature </h3>
	<dl>
	  <dt><strong>&lt;name&gt;<a name="name" id="name"></a></strong></dt>
	  <dd>User-defined
text displayed in the 3D viewer as the label for the object (for
example, for a Placemark, Folder, or NetworkLink). </dd>
	  <dt><strong>&lt;visibility&gt;<a name="visibility" id="visibility"></a></strong></dt>
	  <dd>Boolean
value. Specifies whether the feature is drawn in the 3D viewer when it
is initially loaded. In order for a feature to be visible, the
&lt;visibility&gt; tag of all its ancestors must also be set to 1. In
the Google Earth List View, each Feature has a checkbox that allows the
user to control visibility of the Feature.</dd>
	  <dt><strong>&lt;open&gt;<a name="open" id="open"></a></strong></dt>
	  <dd>Boolean
value. Specifies whether a Document or Folder appears closed or open
when first loaded into the Places panel. 0=collapsed (the default),
1=expanded. See also <a href="#liststyle">&lt;ListStyle&gt;</a>. This element applies only to Document, Folder, and NetworkLink. </dd>
	  <dt><span><strong>&lt;atom:author&gt;<a name="atomauthor" id="atomauthor"></a></strong></span></dt>
	  <dd>
      <p><span>KML
2.2 supports new elements for including data about the author and
related website in your KML file. This information is displayed in geo
search results, both in Earth browsers such as Google Earth, and in
other applications such as Google Maps. The ascription elements used in
KML are as follows:</span></p>
	    <ul>
        <li><span><strong>atom:author</strong> element - parent element for atom:name </span></li>
	      <li><span><strong>atom:name</strong> element - the name of the author<a name="atomname" id="atomname"></a></span> </li>
	      <li><span><strong>atom:link</strong> element - contains the <em>href</em> attribute</span></li>
	      <li><span><strong>href</strong> attribute - URL of the web page containing the KML/KMZ file </span></li>
      </ul>
	    <p><span>These elements are defined in the Atom Syndication Format. The complete specification is found at <a href="http://www.w3.org/2005/Atom" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">http://atompub.org.</a> <code></code> (see the <a href="#sampleattribution">sample </a>that follows).<br>
	    </span> </p>
	    <p><span>The &lt;atom:author&gt; element is the parent element for &lt;atom:name&gt;, which specifies the author of the KML feature.</span></p>
    </dd>
	  <dt><span><strong>&lt;atom:link </strong>href="..."<strong> &gt;</strong><a name="atomlink" id="atomlink"></a></span></dt>
	  <dd><span>Specifies the URL of the website containing this KML or KMZ file.</span> <span> Be sure to include the namespace for this element in any KML file that uses it: <code>xmlns:atom="http://www.w3.org/2005/Atom"</code> (see the <a href="#sampleattribution">sample </a>that follows).</span></dd>
	  
	  <dt><strong>&lt;address&gt;<a name="address" id="address"></a></strong></dt>
	  <dd>A
string value representing an unstructured address written as a standard
street, city, state address, and/or as a postal code. You can use the
&lt;address&gt; tag to specify the location of a point instead of using
latitude and longitude coordinates. (However, if a &lt;Point&gt; is
provided, it takes precedence over the &lt;address&gt;.) To find out
which locales are supported for this tag in Google Earth, go to the <a href="http://maps.google.com/support/bin/answer.py?answer=16634">Google Maps Help</a>. </dd>
	  <dt><strong>&lt;xal:AddressDetails&gt;<a name="addressdetails" id="addressdetails"></a></strong> </dt>
	  <dd>A structured address, formatted as xAL, or <a href="http://www.oasis-open.org/committees/ciq/ciq.html#6">eXtensible Address Language</a>,
an international standard for address formatting.
&lt;xal:AddressDetails&gt; is used by KML for geocoding in Google Maps
only. For details, see the <a href="http://www.google.com/apis/maps/documentation/#Geocoding_Etc">Google Maps API documentation</a>. <span>Currently, Google Earth does not use this element; use &lt;address&gt; instead.</span> Be sure to include the namespace for this element in any KML file that uses it: <code>xmlns:xal="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"</code><br>
	  </dd>
	  <dt><strong>&lt;phoneNumber&gt;<a name="phonenumber" id="phonenumber"></a></strong></dt>
	  <dd>A
string value representing a telephone number. This element is used by
Google Maps Mobile only. The industry standard for Java-enabled
cellular phones is RFC2806. <br>
	    For more information, see 
       <a href="http://www.google.com/url?sa=D&amp;q=http%3A%2F%2Fwww.ietf.org%2Frfc%2Frfc2806.txt">http://www.ietf.org/rfc /rfc2806.txt</a>.&nbsp;</dd>
	  <dt><strong>&lt;Snippet </strong>maxLines="2"<strong> &gt;<a name="snippet" id="snippet"></a></strong></dt>
	  <dd>
A short description of the feature. In Google Earth, this description
is displayed in the Places panel under the name of the feature. If a
Snippet is not supplied, the first two lines of the &lt;description&gt;
are used. In Google Earth, if a Placemark contains both a description
and a Snippet, the &lt;Snippet&gt; appears beneath the Placemark in the
Places panel, and the &lt;description&gt; appears in the Placemark's
description balloon. This tag does not support HTML markup.
&lt;Snippet&gt; has a <strong>maxLines</strong> attribute, an integer that specifies the maximum number of lines to display. </dd>
	<dt><strong>&lt;description&gt;<a name="description" id="description"></a></strong></dt>
	  <dd>
	    <p>User-supplied content that appears in the description balloon. </p>
	    <p>The
supported content for the &lt;description&gt; element changed from
Google Earth 4.3 to 5.0. Specific information for each version is
listed out below, followed by information common to both.</p>
	    <p><strong>Google Earth 5.0</strong></p>
	    <p>Google
Earth 5.0 supports plain text content, as well as full HTML and
JavaScript, within description balloons. Contents of the description
tag are rendered by the <a href="http://webkit.org/">WebKit</a> open source web browser engine, and are displayed as they would be in any WebKit-based browser. </p>
	    <p><strong>General restrictions</strong></p>

      <p class="indented">Links
to local files are generally not allowed. This prevents malicious code
from damaging your system or accessing your data. Should you wish to
allow access to your local filesystem, select <strong>Preferences</strong> &gt; <strong>Allow placemark balloons to access local files and personal data</strong>. Links to image files on the local filesystem are always allowed, if contained within an &lt;img&gt; tag.</p>
<p class="indented">Content that has been compressed into a KMZ file can be accessed, even if on the local filesystem.</p>
      <p class="indented">Cookies
are completely disabled, including cookies set or read by content
contained within a iFrame. There are no exceptions to this rule. </p>
      <p class="indented">Doctype declarations are ignored.</p>
		
    </dd><dd>
<p><strong>HTML</strong></p>

	<p class="indented">HTML is mostly rendered as it would be in any WebKit browser.</p>
	<p class="indented">Targets
are ignored when included in HTML written directly into the KML; all
such links are opened as if the target is set to _blank. Any specified
targets are ignored.</p>
	<p class="indented">HTML that is contained in
an iFrame, however, or dynamically generated with JavaScript or DHTML,
will use target="_self" as the default. Other targets can be specified
and are supported.</p>
	<p class="indented">The contents of KMZ files, local anchor links, and <code>;flyto</code> methods cannot be targeted from HTML contained within an iFrame. </p>

<p><strong>JavaScript</strong></p>

	<p class="indented">Most
JavaScript is supported. Dialog boxes can not be created - functions
such as alert() and prompt() will not be displayed. They will, however,
be written to the system console, as will other errors and exceptions.</p>

<p><strong>CSS</strong></p>

	<p class="indented">CSS is allowed. As
with CSS in a regular web browser, CSS can be used to style text, page
elements, and to control the size and appearance of the description
balloon. Because of the way Google Earth treats URLs within description
balloon content, CSS declarations using the 'url' function (such as <code>background-image: url('http://www.example.com/background.png');</code>) will not work correctly. Any such declarations should be placed inline, instead:</p>
	<p class="indented"><code>&lt;body style="url('http://www.example.com/background.png')"&gt;</code></p>

<p><strong>Google Earth 4.3</strong>      </p>
<p>The &lt;description&gt; element supports plain text as well as a subset of HTML formatting elements, including tables (see <a href="#descriptionexample">KML example</a>
below). It does not support other web-based technology, such as dynamic
page markup (PHP, JSP, ASP), scripting languages (VBScript,
Javascript), nor application languages (Java, Python). <span>In Google Earth release 4.2, video is supported. (See <a href="#samplevideo">Example</a> below.)</span> </p>
        <p><strong>Common information</strong> </p>
        <p>If
your description contains no HTML markup, Google Earth attempts to
format it, replacing newlines with &lt;br&gt; and wrapping URLs with
anchor tags. A valid URL string for the World Wide Web is automatically
converted to a hyperlink to that URL (e.g., <em>http://www.google.com</em>). Consequently, you do not need to surround a URL with the <span class="code">&lt;a href="http://.."&gt;&lt;/a&gt;</span> tags in order to achieve a simple link. </p>
        <p>When
using HTML to create a hyperlink around a specific word, or when
including images in the HTML, you must use HTML entity references or
the CDATA element to escape angle brackets, apostrophes, and other
special characters. The CDATA element tells the XML parser to ignore
special characters used within the brackets. This element takes the
form of:</p>
  <pre>&lt;![CDATA[
  special characters here
]]&gt; </pre>
        <p>If you prefer not to use the CDATA element, you can use entity references to replace all the special characters. </p>
  <pre>&lt;description&gt;
  &lt;![CDATA[
This is an image 
&lt;img src="icon.jpg"&gt; <br>and we have a link http://www.google.com.
  ]]&gt;
&lt;/description&gt;</pre>
        <p><em>Other Behavior Specified Through Use of the &lt;a&gt; Element</em><a name="featureanchor" id="featureanchor"></a></p>
        <p><span>KML  supports the use of two attributes within the &lt;a&gt; element:  <strong>href</strong> and  <strong>type</strong>.</span>   
        </p>
        <p><span> The anchor element &lt;a&gt; contains an <em>href</em> attribute that specifies a URL.</span></p>
        <p><span>If the <em>href</em> is a KML file and has a <em>.kml</em> or <em>.kmz</em>
file extension, Google Earth loads that file directly when the user
clicks it. If the URL ends with an extension not known to Google Earth
(for example, <em>.html</em>), the URL is sent to the browser.</span></p>
    </dd><dd>
	    <p><span>The <em>href</em>
can be a fragment URL (that is, a URL with a # sign followed by a KML
identifier). When the user clicks a link that includes a fragment URL,
by default the browser flies to the Feature whose ID matches the
fragment. If the Feature has a LookAt or Camera element, the Feature is
viewed from the specified viewpoint. </span> </p>
			<p><span>The behavior can be further specified by appending one of the following three strings to the fragment URL:</span></p>
			
			<ul>
	      <li><span><em>;flyto</em> (default) - fly to the Feature</span></li>
	      <li><span><em>;balloon</em> - open the Feature's balloon but do not fly to the Feature </span></li>
	      <li><span><em>;balloonFlyto</em> - open the Feature's balloon and fly to the Feature </span></li>
      </ul>
			
	    <p><span>For example, the following code indicates to open the file <em>CraftsFairs.kml</em>, fly to the Placemark whose ID is "Albuquerque," and open its balloon:</span></p>
	    <pre>&lt;description&gt;
  &lt;![CDATA[ <br>    &lt;a href="http://myServer.com/CraftsFairs.kml#Albuquerque;balloonFlyto"&gt;<br>      One of the Best Art Shows in the West&lt;/a&gt;
  ]]&gt;
&lt;/description&gt; </pre>
			
	    <p><span>The <em>type</em> attribute is used within the &lt;a&gt; element when the <em>href</em> does not end in <em>.kml</em> or <em>.kmz</em>, but the reference needs to be interpreted in the context of KML. Specify the following: </span></p>
	    <pre><span>type="<strong>application/vnd.google-earth.kml+xml</strong>" </span></pre>
	       
	  <p><span>For example, the following URL uses the <code>type</code> attribute to notify Google Earth that it should attempt to load the file, even though the file extension is <em>.php</em>:</span></p>
		<pre><span>&lt;a href="myserver.com/cgi-bin/generate-kml.php#placemark123"
   type="application/vnd.google-earth.kml+xml"&gt;</span></pre>
</dd><dd>
</dd></dl>
		
		
	<dl>
	  <dt><span><em><strong>&lt;AbstractView&gt;</strong></em></span></dt>
	  <dd><span>Defines a viewpoint associated with any element derived from Feature. See <a href="#camera">&lt;Camera&gt;</a> and <a href="#lookat">&lt;LookAt&gt;</a>. </span></dd>
		<dt><em><strong>&lt;TimePrimitive&gt;</strong></em>
		</dt><dd>Associates this Feature with a period of time (<a href="#timespan">&lt;TimeSpan&gt;</a>) or a point in time (<a href="#timestamp">&lt;TimeStamp&gt;</a>).
	  </dd><dt><strong>&lt;styleUrl&gt;<a name="styleurl" id="styleurl"></a></strong></dt>
	  <dd>URL  of a <a href="#style">&lt;Style&gt;</a> or <a href="#stylemap">&lt;StyleMap&gt;</a> defined in a Document. If the style is in the same file, use a <strong>#</strong> reference. If the style is defined in an external file, use a full URL along with # referencing. Examples are
        <pre>&lt;styleUrl&gt;#myIconStyleID&lt;/styleUrl&gt;</pre>
<pre>&lt;styleUrl&gt;http://someserver.com/somestylefile.xml#restaurant&lt;/styleUrl&gt;</pre>
<pre>&lt;styleUrl&gt;eateries.kml#my-lunch-spot&lt;/styleUrl&gt;</pre> 
    </dd>
	  <dt><strong>&lt;<em>StyleSelector</em>&gt;</strong></dt>
	  <dd>One
or more Styles and StyleMaps can be defined to customize the appearance
of any element derived from Feature or of the Geometry in a Placemark.
(See <a href="#balloonstyle">&lt;BalloonStyle&gt;</a>, <a href="#liststyle">&lt;ListStyle&gt;</a>, <a href="#styleselector">&lt;StyleSelector&gt;</a>, <a href="#balloonstyle"></a>and the styles derived from <a href="#colorstyle">&lt;ColorStyle&gt;</a>.)
A style defined within a Feature is called an "inline style" and
applies only to the Feature that contains it. A style defined as the
child of a &lt;Document&gt; is called a "shared style." A shared style
must have an <em>id</em> defined for it. This id is referenced by one
or more Features within the &lt;Document&gt;. In cases where a style
element is defined both in a shared style and in an inline style for a
Feature—that is, a Folder, GroundOverlay, NetworkLink, Placemark, or
ScreenOverlay—the value for the Feature's inline style takes precedence
over the value for the shared style. </dd>
	  <dt><strong>&lt;Region&gt;</strong></dt>
	  <dd>Features and geometry  associated with a Region are drawn only when the Region is active. See <a href="#region">&lt;Region&gt;</a>. </dd>
	  <dt><strong>&lt;Metadata&gt;<a name="metadata" id="metadata"></a></strong> <span>(deprecated in KML 2.2; use &lt;ExtendedData&gt; instead)</span> </dt>
	  
 <dt><strong><span><a href="#extendeddata">&lt;ExtendedData&gt;</a></span></strong></dt>
 <dd><span>Allows
you to add custom data to a KML file. This data can be (1) data that
references an external XML schema, (2) untyped data/value pairs, or (3)
typed data. A given KML Feature can contain a combination of these
types of custom data. </span></dd>
</dl>
<h3>Sample Use of HTML Elements within a Description <a name="descriptionexample" id="descriptionexample"></a></h3>
	<p>This example illustrates the complete set of HTML elements supported by the &lt;description&gt; element <strong>in Google Earth 4.3</strong>. Google Earth 5.0 supports full HTML and JavaScript.</p>
	<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>&lt;kml xmlns="http://www.opengis.net/kml/2.2"&gt;<br><strong>&lt;Placemark&gt;</strong><br>  &lt;name&gt;Feature.kml&lt;/name&gt;
  &lt;Snippet maxLines="4"&gt;<br>    The snippet is a way of<br>    providing an alternative<br>    description that will be<br>    shown in the List view.<br>  &lt;/Snippet&gt; <br>  &lt;description&gt;<br>    &lt;![CDATA[<br>      Styles: &lt;i&gt;Italics&lt;/i&gt;, &lt;b&gt;Bold&lt;/b&gt;, &lt;u&gt;Underlined&lt;/u&gt;, <br>      &lt;s&gt;Strike Out&lt;/s&gt;, subscript&lt;sub&gt;subscript&lt;/sub&gt;,<br>      superscript&lt;sup&gt;superscript&lt;/sup&gt;,  <br>      &lt;big&gt;Big&lt;/big&gt;, &lt;small&gt;Small&lt;/small&gt;, &lt;tt&gt;Typewriter&lt;/tt&gt;,<br>      &lt;em&gt;Emphasized&lt;/em&gt;, &lt;strong&gt;Strong&lt;/strong&gt;, &lt;code&gt;Code&lt;/code&gt;<br>      &lt;hr /&gt;<br>      Fonts: <br>      &lt;font color="red"&gt;red by name&lt;/font&gt;, <br>      &lt;font color="#408010"&gt;leaf green by hexadecimal RGB&lt;/font&gt;, <br>      &lt;font size=1&gt;size 1&lt;/font&gt;, &lt;font size=2&gt;size 2&lt;/font&gt;,<br>      &lt;font size=3&gt;size 3&lt;/font&gt;, &lt;font size=4&gt;size 4&lt;/font&gt;,<br>      &lt;font size=5&gt;size 5&lt;/font&gt;, &lt;font size=6&gt;size 6&lt;/font&gt;, <br>      &lt;font size=7&gt;size 7&lt;/font&gt;,<br>      &lt;font face=times&gt;Times&lt;/font&gt;, <br>      &lt;font face=verdana&gt;Verdana&lt;/font&gt;, <br>      &lt;font face=arial&gt;Arial&lt;/font&gt;<br>      &lt;br/&gt;<br>      &lt;hr /&gt;<br>      Links:<br>      &lt;a href="http://doc.trolltech.com/3.3/qstylesheet.html"&gt;<br>      QT Rich Text Rendering<br>      &lt;/a&gt;<br>      &lt;br /&gt;<br>      &lt;hr /&gt;<br>      Alignment:<br>      &lt;br /&gt;<br>      &lt;p align=left&gt;left&lt;/p&gt;&lt;p align=center&gt;center&lt;/p&gt;<br>      &lt;p align=right&gt;right&lt;/p&gt;<br>      &lt;hr /&gt;<br>      Ordered Lists:<br>      &lt;br /&gt;<br>      &lt;ol&gt;&lt;li&gt;First&lt;/li&gt;&lt;li&gt;Second&lt;/li&gt;&lt;li&gt;Third&lt;/li&gt;&lt;/ol&gt;<br>      &lt;ol type="a"&gt;&lt;li&gt;First&lt;/li&gt;&lt;li&gt;Second&lt;/li&gt;&lt;li&gt;Third&lt;/li&gt;&lt;/ol&gt;<br>      &lt;ol type="A"&gt;&lt;li&gt;First&lt;/li&gt;&lt;li&gt;Second&lt;/li&gt;&lt;li&gt;Third&lt;/li&gt;&lt;/ol&gt;<br>      &lt;hr /&gt;<br>      Unordered Lists:<br>      &lt;br /&gt;<br>      &lt;ul&gt;&lt;li&gt;A&lt;/li&gt;&lt;li&gt;B&lt;/li&gt;&lt;li&gt;C&lt;/li&gt;&lt;/ul&gt;<br>      &lt;ul type="circle"&gt;&lt;li&gt;A&lt;/li&gt;&lt;li&gt;B&lt;/li&gt;&lt;li&gt;C&lt;/li&gt;&lt;/ul&gt;<br>      &lt;ul type="square"&gt;&lt;li&gt;A&lt;/li&gt;&lt;li&gt;B&lt;/li&gt;&lt;li&gt;C&lt;/li&gt;&lt;/ul&gt;<br>      &lt;hr /&gt;<br>      Definitions:<br>      &lt;br /&gt;<br>      &lt;dl&gt;<br>      &lt;dt&gt;Scrumpy&lt;/dt&gt;<br>      &lt;dd&gt;Hard English cider from the west country&lt;/dd&gt;<br>      &lt;dt&gt;Pentanque&lt;/dt&gt;<br>      &lt;dd&gt;A form of boules where the goal is to throw metal ball as<br>      close as possible to a jack&lt;/dd&gt;<br>      &lt;/dl&gt;<br>      &lt;hr /&gt;<br>      Block Quote:<br>      &lt;br /&gt;<br>      &lt;blockquote&gt;<br>      We shall not cease from exploration&lt;br /&gt;<br>      And the end of all our exploring&lt;br /&gt;<br>      Will be to arrive where we started&lt;br /&gt;<br>      And know the place for the first time<br>      &lt;/blockquote&gt;<br>      &lt;br /&gt;<br>      &lt;hr /&gt;<br>      Centered:<br>      &lt;br /&gt;<br>      &lt;center&gt;See, I have a Rhyme assisting&lt;br /&gt;<br>      my feeble brain,&lt;br /&gt;<br>      its tasks oft-times resisting!&lt;/center&gt;<br>      &lt;hr /&gt;<br>      Headings:<br>      &lt;br /&gt;<br>      &lt;h1&gt;Header 1&lt;/h1&gt;<br>      &lt;h2&gt;Header 2&lt;/h2&gt;<br>      &lt;h3&gt;Header 3&lt;/h3&gt;<br>      &lt;h3&gt;Header 4&lt;/h4&gt;<br>      &lt;h3&gt;Header 5&lt;/h5&gt;<br>      &lt;hr /&gt;<br>      Images:<br>      &lt;br /&gt;<br>      &lt;img src="http://earth.google.com/images/googleearth.gif" /&gt;<br>      &lt;br /&gt;<br>      &lt;i&gt;Scaled image&lt;/i&gt;<br>      &lt;br /&gt;<br>      &lt;img src="http://earth.google.com/images/googleearth.gif"<br>      width="100" /&gt;<br>      &lt;br /&gt;<br>      &lt;hr /&gt;<br>      Tables:<br>      &lt;table border="1" padding="3" width="300"&gt;<br>      &lt;tr&gt;&lt;td&gt;1&lt;/td&gt;&lt;td&gt;2&lt;/td&gt;&lt;td&gt;3&lt;/td&gt;&lt;td&gt;4&lt;/td&gt;&lt;td&gt;5&lt;/td&gt;&lt;/tr&gt;<br>      &lt;tr&gt;&lt;td&gt;a&lt;/td&gt;&lt;td&gt;b&lt;/td&gt;&lt;td&gt;c&lt;/td&gt;&lt;td&gt;d&lt;/td&gt;&lt;td&gt;e&lt;/td&gt;&lt;/tr&gt;<br>      &lt;/table&gt;<br>    ]]&gt;<br>  &lt;/description&gt;
  &lt;Point&gt;<br>    &lt;coordinates&gt;-122.378927,37.826793,0&lt;/coordinates&gt;<br>  &lt;/Point&gt;<br><strong>&lt;/Placemark&gt;</strong><br>&lt;/kml&gt;</pre>
	
	<h3><span>Sample Use of  Ascription Elements<a name="sampleattribution" id="sampleattribution"></a></span></h3>
	<p><span>This
example shows use of the &lt;atom:author&gt;, &lt;atom:name&gt; and
&lt;atom:link&gt; elements from the Atom namespace. Note that you need
to reference this namespace within the &lt;kml&gt; element. </span>
	</p><pre>&lt;kml xmlns="http://www.opengis.net/kml/2.2"       
     <strong>xmlns:atom="http://www.w3.org/2005/Atom"&gt; </strong>  
  &lt;Document&gt;         
    <strong>&lt;atom:author&gt;</strong>             
    <strong>  &lt;atom:name&gt;</strong>J. K. Rowling<strong>&lt;/atom:name&gt;</strong>         
    <strong>&lt;/atom:author&gt;</strong>         
    <strong>&lt;atom:link href="http://www.harrypotter.com" /&gt;</strong>
    &lt;Placemark&gt;             
      &lt;name&gt;Hogwarts&lt;/name&gt;             
      &lt;Point&gt;                 
        &lt;coordinates&gt;1,1&lt;/coordinates&gt;             
      &lt;/Point&gt;         
    &lt;/Placemark&gt;         
    &lt;Placemark&gt;       
      &lt;name&gt;Little Hangleton&lt;/name&gt;       
      &lt;Point&gt;         
        &lt;coordinates&gt;1,2&lt;/coordinates&gt;       
      &lt;/Point&gt;         
    &lt;/Placemark&gt;     
  &lt;/Document&gt;  
&lt;/kml&gt;</pre>
<a name="samplevideo"></a>
<h3></h3>
<p><span>This example shows how to embed a Flash video inside the Balloon.</span></p>
<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>&lt;kml xmlns="http://www.opengis.net/kml/2.2"&gt;<br>  &lt;Document&gt;      
    &lt;name&gt;Video Example&lt;/name&gt;<br>    &lt;Style id="sn_blue-dot_copy3"&gt;<br>      &lt;IconStyle&gt;<br>        &lt;Icon&gt;<br>          &lt;href&gt;http://www.google.com/intl/en_us/mapfiles/ms/icons/blue-dot.png&lt;/href&gt;<br>        &lt;/Icon&gt;<br>      &lt;/IconStyle&gt;<br>    &lt;/Style&gt;<br>    &lt;Placemark&gt;<br>      &lt;name&gt;Placemark&lt;/name&gt;<br>      &lt;description&gt;<br>        &lt;![CDATA[&lt;div style="font-size:larger"&gt;<br>          &lt;div&gt;<br>            &lt;div style="width: 212px; font-size: 12px;"&gt;<br>              &lt;b&gt;The Spaghetti Film&lt;/b&gt;<br>            &lt;/div&gt;<br>            &lt;div style="font-size: 11px;"&gt;<br>              &lt;a target="_blank" href="http://www.youtube.com/?v=FICUvrVlyXc"&gt;<br>                http://www.youtube.com/?v=FICUvrVlyXc&lt;/a&gt;&lt;br&gt;<br>            &lt;/div&gt;&lt;br&gt;<br>            &lt;div style="margin-left: auto; margin-right:auto;"&gt;<br>              &lt;object height="175" width="212"&gt;<br>                &lt;param value="http://www.youtube.com/v/FICUvrVlyXc" name="movie"&gt;<br>                &lt;param value="transparent" name="wmode"&gt;<br>                <strong>&lt;embed wmode="transparent" type="application/x-shockwave-flash"<br>                   src="http://www.youtube.com/v/FICUvrVlyXc" height="175"<br>                   width="212"&gt;</strong><br>               &lt;/object&gt;<br>             &lt;/div&gt;<br>           &lt;/div&gt;<br>          &lt;/div&gt;<br>          &lt;div style="font-size: smaller; margin-top: 1em;"&gt;Saved from <br>            &lt;a href="http://maps.google.com/ig/add?synd=mpl&amp;pid=mpl&amp;moduleurl=<br>                http:%2F%2Fwww.google.com%2Fig%2Fmodules%2Fmapplets-youtube.xml&amp;hl=en&amp;gl=us"&gt;<br>                YouTubeVideos&lt;/a&gt;<br>          &lt;/div&gt;<br>         ]]&gt;<br>      &lt;/description&gt;<br>      &lt;styleUrl&gt;#sn_blue-dot_copy3&lt;/styleUrl&gt;<br>      &lt;Point&gt;<br>        &lt;coordinates&gt;-93.47875999999999,45.083248,0&lt;/coordinates&gt;<br>      &lt;/Point&gt;<br>    &lt;/Placemark&gt;<br>&lt;/Document&gt;
&lt;/kml&gt;
</pre>

	<h3>Extends</h3>
	<ul>
	  <li><a href="#object">&lt;<em>Object</em>&gt;</a></li>
</ul>
	<h3>Extended By </h3>
	<ul>
	  <li><a href="#container">&lt;<em>Container&gt;</em></a> </li>
	  <li><a href="#overlay">&lt;Overlay&gt;</a></li>
	  <li><a href="#placemark">&lt;Placemark&gt;</a></li>
	  <li>&lt;NetworkLink&gt;</li>
	  <li>&lt;gx:Tour&gt;</li>
	</ul>
	
<h2><a name="gxflyto"></a>&lt;gx:FlyTo&gt;</h2>

<table class="note" width="60%">
<tbody><tr><td class="note">This element is an extension of the <a href="http://www.opengeospatial.org/standards/kml/">OGC KML 2.2 standard</a> and is supported in Google Earth 5.0. <a href="#kmlextensions">Learn more</a></td></tr></tbody></table>

<h3>Syntax</h3>
<pre>&lt;gx:FlyTo&gt;
  &lt;gx:duration&gt;0.0&lt;/gx:duration&gt;         &lt;!-- double --&gt;
  &lt;gx:flyToMode&gt;bounce&lt;/gx:duration&gt;      &lt;!-- <em>smooth</em> or <em>bounce</em> --&gt;
  &lt;!-- AbstractView --&gt;                   &lt;!-- <em>Camera</em> or <em>LookAt</em> --&gt; 
    ...
  &lt;!-- /AbstractView --&gt;
&lt;/gx:FlyTo&gt;</pre>
<h3>Description </h3>
<p><code>&lt;gx:FlyTo&gt;</code> specifies a point in space to which the browser will fly during a tour. It must contain one <a href="#abstractview">AbstractView</a>, and should contain <code>&lt;gx:duration&gt;</code> and <code>&lt;gx:flyToMode&gt;</code>
elements, which specify the time it takes to fly to the defined point
from the current point, and the method of flight, respectively.</p>
<h3><a name="gxflytomode"></a>&lt;gx:flyToMode&gt;</h3>
<p>There are two allowed values for <code>&lt;gx:flyToMode&gt;</code>: <strong>smooth</strong>, and <strong>bounce</strong>.</p>
<ul>
  <li><strong>Smooth</strong> FlyTos allow for an unbroken flight
from point to point to point (and on). An unbroken series of smooth
FlyTos will begin and end at zero velocity, and will not slow at each
point. A series of smooth FlyTos is broken by any of the following
elements: <ul>
      <li><code>&lt;gx:flyToMode&gt;bounce&lt;/gx:flyToMode&gt;</code></li>
      <li><code>&lt;gx:Wait&gt;</code></li>
    </ul>
This means that velocity will be zero at the smooth FlyTo immediately
preceding either of the above elements. A series of smooth FlyTos is
not broken by <a href="http://code.google.com/intl/de/apis/kml/documentation/gxanimatedupdate">&lt;gx:AnimatedUpdate&gt;</a> elements.</li><br>
  <li><strong>Bounce</strong> FlyTos each begin and end at zero velocity.</li>
</ul>
<h3><strong>Example</strong></h3>
<pre>&lt;gx:FlyTo&gt;<br>  &lt;gx:duration&gt;2.55&lt;/gx:duration&gt;<br>  &lt;gx:flyToMode&gt;smooth&lt;/gx:flyToMode&gt;<br>  &lt;Camera&gt;<br>    &lt;longitude&gt;-113.084448&lt;/longitude&gt;<br>    &lt;latitude&gt;36.567081&lt;/latitude&gt;<br>    &lt;altitude&gt;41277.571403&lt;/altitude&gt;<br>    &lt;heading&gt;116.150227&lt;/heading&gt;<br>    &lt;altitudeMode&gt;absolute&lt;/altitudeMode&gt;<br>  &lt;/Camera&gt;<br>&lt;/gx:FlyTo&gt;</pre>
<h3>Extends</h3>
<ul>
  <li><a href="#gxabstracttourprimitive">&lt;gx:TourPrimitive&gt;</a></li>
</ul>
<h3>Contains</h3>
<ul>
  <li><a href="#gxduration">&lt;gx:duration&gt;</a></li>
  <li><a href="#gxflytomode">&lt;gx:flyToMode&gt;</a></li>
  <li><a href="#abstractview">&lt;AbstractView&gt;</a></li>
</ul>

<p><a name="folder"></a>
    </p>
<h2>&lt;Folder&gt;</h2>	<h3>Syntax </h3>
  <pre><strong>&lt;Folder id="ID"&gt;</strong>
  &lt;!-- inherited from <em>Feature</em> element --&gt;
  &lt;name&gt;<em>...</em>&lt;/name&gt;                      &lt;!-- string --&gt;
  &lt;visibility&gt;1&lt;/visibility&gt;            &lt;!-- boolean --&gt;
  &lt;open&gt;0&lt;/open&gt;                        &lt;!-- boolean --&gt;
  <span>&lt;atom:author&gt;...&lt;atom:author&gt;         &lt;!-- xmlns:atom --&gt;
  &lt;atom:link&gt;...&lt;/atom:link&gt;</span><span>            &lt;!-- xmlns:atom --&gt;</span>
  &lt;address&gt;<em>...</em>&lt;/address&gt;                &lt;!-- string --&gt;
  &lt;xal:AddressDetails&gt;...&lt;/xal:AddressDetails&gt;  &lt;!-- xmlns:xal --&gt;<br>  &lt;phoneNumber&gt;...&lt;/phoneNumber&gt;        &lt;!-- string --&gt;<br>  &lt;Snippet maxLines="2"&gt;<em>...</em>&lt;/Snippet&gt;   &lt;!-- string --&gt;
  &lt;description&gt;<em>...</em>&lt;/description&gt;        &lt;!-- string --&gt;
  <span><em>&lt;AbstractView&gt;...&lt;/AbstractView&gt;</em>      &lt;!-- Camera <em>or</em> LookAt --&gt;</span>
  &lt;<em>TimePrimitive</em>&gt;...&lt;/<em>TimePrimitive</em>&gt;
  &lt;styleUrl&gt;<em>...</em>&lt;/styleUrl&gt;              &lt;!-- anyURI --&gt;
  &lt;<em>StyleSelector&gt;...&lt;/StyleSelector&gt;</em>
  &lt;Region&gt;...&lt;/Region&gt;
  <span>&lt;Metadata&gt;...&lt;/Metadata&gt;              &lt;!-- deprecated in KML 2.2 --&gt;
  &lt;ExtendedData&gt;...&lt;/ExtendedData&gt;      &lt;!-- new in KML 2.2 --&gt;

  </span>&lt;!-- specific to Folder --&gt;
  &lt;!-- 0 or more <em>Feature</em> elements --&gt;
<strong>&lt;/Folder</strong>&gt;
</pre>
    <h3>Description </h3>
    <p>A Folder is used to arrange
other Features hierarchically (Folders, Placemarks, NetworkLinks, or
Overlays). A Feature is visible only if it and all its ancestors are
visible.<!-- See <a href="kml_basics.html">KML Basics</a> for more information on grouping mechanisms.</p> -->
     </p><h3>Example</h3>
     <pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>&lt;kml xmlns="http://www.opengis.net/kml/2.2"&gt;<br><strong>&lt;Folder&gt;</strong><br>  &lt;name&gt;Folder.kml&lt;/name&gt;
  &lt;open&gt;1&lt;/open&gt;<br>  &lt;description&gt;<br>    A folder is a container that can hold multiple other objects<br>  &lt;/description&gt;<br>  &lt;Placemark&gt;<br>    &lt;name&gt;Folder object 1 (Placemark)&lt;/name&gt;<br>    &lt;Point&gt;<br>      &lt;coordinates&gt;-122.377588,37.830266,0&lt;/coordinates&gt;<br>    &lt;/Point&gt;<br>  &lt;/Placemark&gt;<br>  &lt;Placemark&gt;<br>    &lt;name&gt;Folder object 2 (Polygon)&lt;/name&gt;<br>    &lt;Polygon&gt;<br>      &lt;outerBoundaryIs&gt;<br>        &lt;LinearRing&gt;<br>          &lt;coordinates&gt;<br>            -122.377830,37.830445,0<br>            -122.377576,37.830631,0<br>            -122.377840,37.830642,0<br>            -122.377830,37.830445,0<br>          &lt;/coordinates&gt;<br>        &lt;/LinearRing&gt;<br>      &lt;/outerBoundaryIs&gt;<br>    &lt;/Polygon&gt;<br>  &lt;/Placemark&gt;<br>  &lt;Placemark&gt;<br>    &lt;name&gt;Folder object 3 (Path)&lt;/name&gt;<br>    &lt;LineString&gt;<br>      &lt;tessellate&gt;1&lt;/tessellate&gt;<br>      &lt;coordinates&gt;<br>        -122.378009,37.830128,0 -122.377885,37.830379,0<br>      &lt;/coordinates&gt;<br>    &lt;/LineString&gt;<br>  &lt;/Placemark&gt;<br><strong>&lt;/Folder&gt;</strong><br>&lt;/kml&gt;</pre> 
	
<h3>Extends</h3>
<ul>
  <li><a href="#container">&lt;<em>Container</em>&gt;</a></li>
</ul>
       
<h3>Contains</h3> 
<ul> 
  <li>Any element derived from <a href="#feature">&lt;<em>Feature</em>&gt;</a></li> 
</ul> 
	
<a name="geometry"></a>
<h2>&lt;<em>Geometry</em>&gt;</h2>
<h3>Syntax </h3> 
<pre>&lt;!-- abstract element; do not create --&gt;
<strong>&lt;!<em>-- Geometry</em> id="ID" --&gt;                 &lt;!-- Point,LineString,LinearRing,
                                               Polygon,MultiGeometry,Model --&gt;</strong>
<strong>&lt;!-- /<em>Geometry --</em>&gt;</strong></pre>
<h3>Description</h3>
<p>This is an abstract element and cannot be used directly in a KML
file. It provides a placeholder object for all derived Geometry
objects. </p>

	
<h3>Extends</h3>
	<ul>
	  <li><a href="#object">&lt;<em>Object</em>&gt;</a></li>
  </ul>
<h3>Extended By </h3>
	<ul>
	  <li><a href="#point">&lt;Point&gt;</a></li>
	  <li><a href="#linestring">&lt;LineString&gt;</a></li>
	  <li><a href="#linearring">&lt;LinearRing&gt;</a></li>
	  <li>&lt;<a href="#polygon">Polygon</a>&gt;</li>
	  <li>&lt;<a href="#multigeometry">MultiGeometry</a>&gt;</li>
	  <li><a href="#model">&lt;Model&gt;</a></li>
	</ul>
	
<a name="groundoverlay"></a>
<h2>&lt;GroundOverlay&gt;</h2>
<h3>Syntax </h3>

<pre><strong>&lt;GroundOverlay id="ID"&gt;</strong>
  &lt;!-- inherited from <em>Feature</em> element --&gt;
  &lt;name&gt;<em>...</em>&lt;/name&gt;                      &lt;!-- string --&gt;
  &lt;visibility&gt;1&lt;/visibility&gt;            &lt;!-- boolean --&gt;
  &lt;open&gt;0&lt;/open&gt;                        &lt;!-- boolean --&gt;
  <span>&lt;atom:author&gt;...&lt;atom:author&gt;         &lt;!-- xmlns:atom --&gt;
  &lt;atom:link&gt;...&lt;/atom:link&gt;</span><span>            &lt;!-- xmlns:atom --&gt;</span>
  &lt;address&gt;<em>...</em>&lt;/address&gt;                &lt;!-- string --&gt;
  &lt;xal:AddressDetails&gt;...&lt;/xal:AddressDetails&gt;  &lt;!-- xmlns:xal --&gt;<br>  &lt;phoneNumber&gt;...&lt;/phoneNumber&gt;        &lt;!-- string --&gt;<br>  &lt;Snippet maxLines="2"&gt;<em>...</em>&lt;/Snippet&gt;   &lt;!-- string --&gt;
  &lt;description&gt;<em>...</em>&lt;/description&gt;        &lt;!-- string --&gt;
  <span><em>&lt;AbstractView&gt;...&lt;/AbstractView&gt;</em>      &lt;!-- Camera <em>or</em> LookAt --&gt;</span>
  &lt;<em>TimePrimitive</em>&gt;...&lt;/<em>TimePrimitive</em>&gt;
  &lt;styleUrl&gt;<em>...</em>&lt;/styleUrl&gt;              &lt;!-- anyURI --&gt;
  &lt;<em>StyleSelector&gt;...&lt;/StyleSelector&gt;</em>
  &lt;Region&gt;...&lt;/Region&gt;
  <span>&lt;Metadata&gt;...&lt;/Metadata&gt;              &lt;!-- deprecated in KML 2.2 --&gt;
  &lt;ExtendedData&gt;...&lt;/ExtendedData&gt;      &lt;!-- new in KML 2.2 --&gt;</span>

  &lt;!-- inherited from <em>Overlay</em> element --&gt;
  &lt;color&gt;ffffffff&lt;/color&gt;                   &lt;!-- kml:color --&gt;
  &lt;drawOrder&gt;0&lt;/drawOrder&gt;                  &lt;!-- int --&gt;  
  &lt;Icon&gt;...&lt;/Icon&gt;

  &lt;!-- specific to GroundOverlay --&gt;
  &lt;altitude&gt;0&lt;/altitude&gt;                    &lt;!-- double --&gt;
  &lt;altitudeMode&gt;clampToGround&lt;/altitudeMode&gt;
     &lt;!-- kml:altitudeModeEnum: clampToGround or absolute --&gt; 
	   &lt;!-- or, substitute gx:altitudeMode: clampToSeaFloor or relativeToSeaFloor --&gt;
  &lt;LatLonBox&gt;
    &lt;north&gt;...&lt;/north&gt;                      &lt;! kml:angle90 --&gt;
    &lt;south&gt;<em>...</em>&lt;/south&gt;                      &lt;! kml:angle90 --&gt;
    &lt;east&gt;<em>...</em>&lt;/east&gt;                        &lt;! kml:angle180 --&gt;
    &lt;west&gt;<em>...</em>&lt;/west&gt;                        &lt;! kml:angle180 --&gt;
    &lt;rotation&gt;0&lt;/rotation&gt;                  &lt;! kml:angle180 --&gt;
  &lt;/LatLonBox&gt;
<strong>&lt;/GroundOverlay&gt;</strong></pre>

<h3>Description </h3>
<p>This element draws an image overlay draped onto the terrain. The
&lt;href&gt; child of &lt;Icon&gt; specifies the image to be used as
the overlay. This file can be either on a local file system or on a web
server. If this element is omitted or contains no &lt;href&gt;, a
rectangle is drawn using the color and <code>LatLonBox</code> bounds defined by the ground overlay.</p>
    
<h3>Elements Specific to GroundOverlay </h3>
<dl>
  <dt><strong>&lt;altitude&gt; </strong> </dt>
  <dd> Specifies the distance above the earth's surface, in meters, and is interpreted according to the altitude mode.</dd>
	<dt><strong>&lt;altitudeMode&gt;</strong></dt>
	<dd> Specifies how the &lt;altitude&gt;is interpreted. Possible values are
    <ul>
      <li><strong>clampToGround</strong> - (default) Indicates to ignore the altitude specification and drape the overlay over the terrain.</li>
      <li><strong>absolute</strong>
- Sets the altitude of the overlay relative to sea level, regardless of
the actual elevation of the terrain beneath the element. For example,
if you set the altitude of an overlay to 10 meters with an absolute
altitude mode, the overlay will appear to be at ground level if the
terrain beneath is also 10 meters above sea level. If the terrain is 3
meters above sea level, the overlay will appear elevated above the
terrain by 7 meters.</li>
      </ul>
  </dd>
	<dt>&lt;gx:altitudeMode&gt;
	    </dt>
    <dd>A KML extension in the <a href="#kmlextensions">Google extension namespace</a>, allowing altitudes relative to the sea floor. Values are:
      <ul>
          <li><strong>relativeToSeaFloor</strong>
- Interprets the &lt;altitude&gt; as a value in meters above the sea
floor. If the point is above land rather than sea, the &lt;altitude&gt;
will be interpreted as being above the ground.</li>
        <li><strong>clampToSeaFloor</strong>
- The &lt;altitude&gt; specification is ignored, and the overlay will
be draped over the sea floor. If the point is on land rather than at
sea, the overlay will be positioned on the ground.</li>
      </ul>
    </dd>

  <dt><strong>&lt;LatLonBox&gt; </strong><em><a name="latlonbox" id="latlonbox"></a></em> </dt>
	<dd>Specifies where the top, bottom, right, and left sides of a bounding box for the ground overlay are aligned. 
	  <ul>
	    <li><strong>&lt;north&gt;</strong><a name="north" id="north"></a>  Specifies the latitude of the north edge of the bounding box, in decimal degrees from 0 to ±90. </li>
	    <li><strong>&lt;south&gt; <a name="south" id="south"></a></strong> Specifies the latitude of the south edge of the bounding box, in decimal degrees from 0 to ±90.</li>
		  <li><strong>&lt;east&gt;</strong><a name="east" id="east"></a>
Specifies the longitude of the east edge of the bounding box, in
decimal degrees from 0 to ±180. (For overlays that overlap the meridian
of 180° longitude, values can extend beyond that range.)</li>
	   <li><strong>&lt;west&gt;</strong><a name="west" id="west"></a>
Specifies the longitude of the west edge of the bounding box, in
decimal degrees from 0 to ±180. (For overlays that overlap the meridian
of 180° longitude, values can extend beyond that range.) </li>
     <li><strong>&lt;rotation&gt;</strong>
Specifies a rotation of the overlay about its center, in degrees.
Values can be ±180. The default is 0 (north). Rotations are specified
in a <span>counterclockwise </span>direction.</li>
	 </ul>
	
	<pre><strong>&lt;LatLonBox&gt;</strong>
   &lt;north&gt;48.25475939255556&lt;/north&gt;
   &lt;south&gt;48.25207367852141&lt;/south&gt;
   &lt;east&gt;-90.86591508839973&lt;/east&gt;
   &lt;west&gt;-90.8714285289695&lt;/west&gt;
   &lt;rotation&gt;39.37878630116985&lt;/rotation&gt;
<strong>&lt;/LatLonBox&gt;</strong> </pre>
  </dd>
</dl>


<h3>Example</h3>
     <pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>&lt;kml xmlns="http://www.opengis.net/kml/2.2"&gt;<br><strong>&lt;GroundOverlay&gt;</strong><br>   &lt;name&gt;GroundOverlay.kml&lt;/name&gt;<br>   &lt;color&gt;7fffffff&lt;/color&gt;<br>   &lt;drawOrder&gt;1&lt;/drawOrder&gt;<br>   &lt;Icon&gt;<br>      &lt;href&gt;http://www.google.com/intl/en/images/logo.gif&lt;/href&gt;<br>      &lt;refreshMode&gt;onInterval&lt;/refreshMode&gt;<br>      &lt;refreshInterval&gt;86400&lt;/refreshInterval&gt;<br>      &lt;viewBoundScale&gt;0.75&lt;/viewBoundScale&gt;<br>   &lt;/Icon&gt;<br>   &lt;LatLonBox&gt;<br>      &lt;north&gt;37.83234&lt;/north&gt;<br>      &lt;south&gt;37.832122&lt;/south&gt;<br>      &lt;east&gt;-122.373033&lt;/east&gt;<br>      &lt;west&gt;-122.373724&lt;/west&gt;<br>      &lt;rotation&gt;45&lt;/rotation&gt;<br>   &lt;/LatLonBox&gt;<br><strong>&lt;/GroundOverlay&gt;</strong><br>&lt;/kml&gt;</pre>
		  
<h3>Extends</h3>
	<ul>
	  <li><a href="#feature">&lt;<em>Feature</em>&gt;</a></li>
	  <li><a href="#overlay">&lt;<em>Overlay</em>&gt;</a></li>
	</ul>
	       
<h3>Contained By </h3> 
    <ul> 
      <li><a href="#document">&lt;Document&gt;</a></li> 
      <li><a href="#folder">&lt;Folder&gt;</a></li> 
    </ul> 
	
<a name="icon"></a>
<h2>&lt;Icon&gt;</h2> 
<h3>Syntax</h3>
    <pre><strong>&lt;Icon id="ID"&gt;</strong>
  &lt;!-- specific to Icon --&gt;
  &lt;href&gt;<em>...</em>&lt;/href&gt;                      &lt;!-- anyURI --&gt;
  &lt;refreshMode&gt;onChange&lt;/refreshMode&gt;   
    &lt;!-- kml:refreshModeEnum: onChange, onInterval, <em>or</em> onExpire --&gt;   
  &lt;refreshInterval&gt;4&lt;/refreshInterval&gt;  &lt;!-- float --&gt;
  &lt;viewRefreshMode&gt;never&lt;/viewRefreshMode&gt; 
    &lt;!-- kml:viewRefreshModeEnum: never, onStop, onRequest, onRegion --&gt;
  &lt;viewRefreshTime&gt;4&lt;/viewRefreshTime&gt;  &lt;!-- float --&gt;
  &lt;viewBoundScale&gt;1&lt;/viewBoundScale&gt;    &lt;!-- float --&gt;
  &lt;viewFormat&gt;...&lt;/viewFormat&gt;          &lt;!-- string --&gt;
  &lt;httpQuery&gt;...&lt;/httpQuery&gt;            &lt;!-- string --&gt;
  <strong>&lt;/Icon&gt;</strong></pre>
	
    <h3>Description</h3>
<p>Defines an image associated with an Icon style or overlay. &lt;Icon&gt; has the same child elements as <a href="#link">&lt;Link&gt;</a>. The required <a href="#href">&lt;href&gt;</a>
child element defines the location of the image to be used as the
overlay or as the icon for the placemark. This location can either be
on a local file system or a remote web server.</p>
    <pre><strong>&lt;Icon&gt;</strong>
  &lt;href&gt;Sunset.jpg&lt;/href&gt;
<strong>&lt;/Icon&gt;</strong></pre> 
    
<h3>Elements Specific to Icon </h3>
<dl> 
  <dt><strong>&lt;href&gt;<a name="href" id="href"></a></strong></dt>
  <dd>An HTTP address or a local file specification used to load an icon. <strong></strong></dd>
	<dt><strong>&lt;x&gt;, &lt;y&gt;, &lt;w&gt;, &lt;h&gt; <a name="w" id="w"></a><a name="h" id="h"></a></strong></dt>
	<dd><em>Use of these elements within &lt;Icon&gt; has been deprecated. </em></dd>
	<dt><a href="#refreshmode"><strong>&lt;refreshMode&gt;</strong></a></dt>
	<dd>For a description of &lt;refreshMode&gt; and the other elements listed below, see <a href="#link">&lt;Link&gt;</a>.</dd>
	<dt><a href="#refreshinterval"><strong>&lt;refreshInterval&gt;</strong></a></dt>
  <dt><a href="#viewrefreshmode"><strong>&lt;viewRefreshMode&gt;</strong></a></dt>
  <dt><a href="#refreshmode"><strong></strong></a><a href="#viewrefreshtime"><strong>&lt;viewRefreshTime&gt;</strong></a></dt>
  <dt><a href="#viewboundscale"><strong>&lt;viewBoundScale&gt;</strong></a></dt>       
  <dt><a href="#viewformat"><strong>&lt;viewFormat&gt;</strong></a> </dt>
  <dt><a href="#httpquery"><strong>&lt;httpQuery&gt;</strong></a></dt>
  <dt><a href="#viewrefreshmode"></a></dt>       
  <dt><a href="#viewrefreshtime"></a></dt>       
</dl>

<h3>Contained By </h3> 
<ul> 
  <li><a href="#groundoverlay">&lt;GroundOverlay&gt;</a></li>
  <li><a href="#screenoverlay">&lt;ScreenOverlay&gt;</a></li> 
  <li><a href="#iconstyle">&lt;IconStyle&gt;</a></li> 
</ul> 

<a name="iconstyle"></a>

<h2>&lt;IconStyle&gt;</h2><h3>Syntax </h3>
    <pre><strong>&lt;IconStyle id="ID"&gt;</strong>
  &lt;!-- inherited from <em>ColorStyle</em> --&gt;
  &lt;color&gt;ffffffff&lt;/color&gt;            &lt;!-- kml:color --&gt;
  &lt;colorMode&gt;normal&lt;/colorMode&gt;      &lt;!-- kml:colorModeEnum:normal <em>or</em> random --&gt;

  &lt;!-- specific to IconStyle --&gt;
  &lt;scale&gt;1&lt;/scale&gt;                   &lt;!-- float --&gt;
  &lt;heading&gt;0&lt;/heading&gt;               &lt;!-- float --&gt;
  &lt;Icon&gt;
    &lt;href&gt;...&lt;/href&gt;
  &lt;/Icon&gt; 
  &lt;hotSpot x="0.5"  y="0.5" 
    xunits="fraction" yunits="fraction"/&gt;    &lt;!-- kml:vec2 --&gt;                    
<strong>&lt;/IconStyle&gt;</strong></pre>

<h3>Description </h3>
<p>Specifies how icons for point Placemarks are drawn, both in the
Places panel and in the 3D viewer of Google Earth. The &lt;Icon&gt;
element specifies the icon image. The &lt;scale&gt; element specifies
the <em>x, y</em> scaling of the icon. <span>The color specified in the &lt;color&gt; element of &lt;IconStyle&gt; is blended with the color of the &lt;Icon&gt;.</span> </p>
    
<h3>Elements Specific to IconStyle</h3>
<dl>
  <dt><strong>&lt;scale&gt;</strong><a name="scale" id="scale"></a></dt>
  <dd>Resizes the icon.</dd>
	<p class="note"><strong>Note:</strong> The &lt;geomScale&gt; tag has been deprecated. Use &lt;scale&gt; instead. <a name="geomscale" id="geomscale"></a></p>
	<dt><strong>&lt;heading&gt;</strong></dt>
  <dd>Direction (that is, North, South, East, West), in degrees. Default=0 (North). (<a href="#headingdiagram">See diagram</a>.) Values range from 0 to 360 degrees.</dd>
  <dt><strong>&lt;Icon&gt;</strong></dt>
	<dd>A custom Icon. In &lt;IconStyle&gt;, the only child element of &lt;Icon&gt; is &lt;href&gt;:
	  <ul>
	    <li><strong>&lt;href&gt;</strong>:  An HTTP address or a local file specification used to load an icon.</li>
	  </ul>
	</dd>
	<dt><strong>&lt;hotSpot x="</strong>0.5"<strong> y="0.</strong>5"<strong> xunits="</strong>fraction"<strong> yunits="</strong>fraction"<strong>&gt;<a name="hotspot" id="hotspot"></a></strong></dt>
	<dd>Specifies the position within the Icon that is "anchored" to the &lt;Point&gt; specified in the Placemark. The <em>x</em> and <em>y</em> values can be specified in three different ways: as <em>pixels</em> (<strong>"pixels"</strong>), as <em>fractions</em> of the icon (<strong>"fraction"</strong><em>)</em>, or as <em>inset pixels </em>(<strong>"insetPixels"</strong>), which is an offset in pixels from the upper right corner of the icon. The <em>x</em> and <em>y</em> positions can be specified in different ways—for example, <em>x</em> can be in pixels and <em>y</em> can be a fraction. The origin of the coordinate system is in the lower left corner of the icon.
     <ul>
       <li><strong>x </strong>- Either the number of pixels, a fractional component of the icon, or a pixel inset indicating the <em>x</em> component of a point on the icon. </li>
      <li><strong>y </strong>- Either the number of pixels, a fractional component of the icon, or a pixel inset indicating the <em>y</em> component of a point on the icon. </li>
      <li><strong>xunits </strong>- Units in which the <em>x</em> value is specified. A value of <strong>fraction</strong> indicates the <em>x</em> value is a fraction of the icon. A value of <strong>pixels</strong> indicates the <em>x</em> value in pixels. A value of <strong>insetPixels</strong> indicates the indent from the right edge of the icon. </li>
      <li><strong>yunits</strong> - Units in which the <em>y</em> value is specified. A value of <strong>fraction</strong> indicates the <em>y</em> value is a fraction of the icon. A value of <strong>pixels</strong> indicates the <em>y</em> value in pixels. A value of <strong>insetPixels</strong> indicates the indent from the top edge of the icon. </li>
    </ul>
	</dd>
<dl>
	
<h3>Example</h3>
	<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>&lt;kml xmlns="http://www.opengis.net/kml/2.2"&gt;<br>&lt;Document&gt;<br>   &lt;Style id="randomColorIcon"&gt;<br>      <strong>&lt;IconStyle&gt;</strong><br>         &lt;color&gt;ff00ff00&lt;/color&gt;<br>         &lt;colorMode&gt;random&lt;/colorMode&gt;<br>         &lt;scale&gt;1.1&lt;/scale&gt;<br>         &lt;Icon&gt;<br>            &lt;href&gt;http://maps.google.com/mapfiles/kml/pal3/icon21.png&lt;/href&gt;<br>         &lt;/Icon&gt;<br>      <strong>&lt;/IconStyle&gt;</strong><br>   &lt;/Style&gt;<br>   &lt;Placemark&gt;<br>      &lt;name&gt;IconStyle.kml&lt;/name&gt;<br>      &lt;styleUrl&gt;#randomColorIcon&lt;/styleUrl&gt;<br>      &lt;Point&gt;<br>         &lt;coordinates&gt;-122.36868,37.831145,0&lt;/coordinates&gt;<br>      &lt;/Point&gt;<br>   &lt;/Placemark&gt;<br>&lt;/Document&gt;<br>&lt;/kml&gt;</pre>
	 
<h3>Extends</h3>
<ul>
  <li><a href="#colorstyle">&lt;<em>ColorStyle</em>&gt;</a></li>
</ul>
       
<h3>Contained By</h3> 
<ul> 
  <li><a href="#style">&lt;Style&gt;</a> </li>
</ul>
 
<h3>Contains </h3> 
<ul> 
  <li><a href="#href">&lt;href&gt;</a> as a child of <a href="#icon">&lt;Icon&gt;</a> </li>      
</ul>
	
<a name="kml"></a>
<h2>&lt;kml&gt;</h2>
<h3>Syntax </h3>
	<pre>&lt;kml xmlns="http://www.opengis.net/kml/2.2" <span>hint="target=sky"</span>&gt; ... &lt;/kml&gt;</pre>
	
  <h3>Description</h3>
<p>The root element of a KML file.  This element is required. It follows the xml declaration at the beginning of the file. <span>The <em>hint</em> attribute is used as a signal to Google Earth to display the file as celestial data.</span></p>
<p><span>The &lt;kml&gt; element may also include the namespace for any external XML schemas that are referenced within the file.</span>  </p>
<p><span>A basic &lt;kml&gt; element contains 0 or 1 Feature and 0 or 1 NetworkLinkControl:</span></p>
<pre>&lt;kml xmlns="http://www.opengis.net/kml/2.2"&gt;
  &lt;NetworkLinkControl&gt; ... &lt;/NetworkLinkControl&gt;
  &lt;!-- 0 or 1<em> Feature</em> elements --&gt;
&lt;/kml&gt;</pre>
<a name="labelstyle"></a>
<h2>&lt;LabelStyle&gt;</h2>
<h3>Syntax </h3>
<pre><strong>&lt;LabelStyle id="ID"&gt;</strong>
  &lt;!-- inherited from <em>ColorStyle</em> --&gt;
  &lt;color&gt;ffffffff&lt;/color&gt;            &lt;!-- kml:color --&gt;
  &lt;colorMode&gt;normal&lt;/colorMode&gt;      &lt;!-- kml:colorModeEnum: normal <em>or</em> random --&gt;

  &lt;!-- specific to LabelStyle --&gt;
  &lt;scale&gt;1&lt;/scale&gt;                   &lt;!-- float --&gt;
<strong>&lt;/LabelStyle&gt;</strong></pre>

<h3>Description </h3>
<p>Specifies how the &lt;name&gt; of a Feature is drawn in the 3D
viewer. A custom color, color mode, and scale for the label (name) can
be specified.</p>
<p class="note"><strong>Note:</strong> The &lt;labelColor&gt; tag is deprecated. Use &lt;LabelStyle&gt; instead. <a name="labelcolor" id="labelcolor"></a></p>

<h3>Specific to &lt;LabelStyle&gt;</h3>
<dl>
  <dt><strong>&lt;scale&gt; <a name="scale" id="scale"></a></strong></dt>
	<dd>Resizes the label.</dd>
</dl>
	
<h3>Example</h3>
<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>&lt;kml xmlns="http://www.opengis.net/kml/2.2"&gt;<br>&lt;Document&gt;<br>   &lt;Style id="randomLabelColor"&gt;<br>      <strong>&lt;LabelStyle&gt;</strong><br>         &lt;color&gt;ff0000cc&lt;/color&gt;<br>         &lt;colorMode&gt;random&lt;/colorMode&gt;<br>         &lt;scale&gt;1.5&lt;/scale&gt;<br>      <strong>&lt;/LabelStyle&gt;</strong><br>   &lt;/Style&gt;<br>   &lt;Placemark&gt;<br>      &lt;name&gt;LabelStyle.kml&lt;/name&gt;<br>      &lt;styleUrl&gt;#randomLabelColor&lt;/styleUrl&gt;<br>      &lt;Point&gt;<br>         &lt;coordinates&gt;-122.367375,37.829192,0&lt;/coordinates&gt;<br>      &lt;/Point&gt;<br>   &lt;/Placemark&gt;<br>&lt;/Document&gt;<br>&lt;/kml&gt;</pre> 

<h3>Extends</h3>
<ul>
  <li><a href="#colorstyle">&lt;<em>ColorStyle</em>&gt;</a></li>
</ul> 
      
<h3>Contained By</h3> 
<ul> 
  <li><a href="#style">&lt;Style&gt;</a></li> 
</ul> 

<h2><a name="gxlatlonquad" id="gxlatlonquad"></a>&lt;gx:LatLonQuad&gt;</h2>

<table class="note" width="60%">
<tbody><tr><td class="note">This element is an extension of the <a href="http://www.opengeospatial.org/standards/kml/">OGC KML 2.2 standard</a> and is supported in Google Earth 5.0. <a href="#kmlextensions">Learn more</a></td></tr></tbody></table><h3>Syntax</h3>

<pre>&lt;GroundOverlay id="ID"&gt;
  ...
  &lt;Icon&gt;...&lt;/Icon&gt;
  &lt;altitude&gt;0&lt;/altitude&gt;
  &lt;altitudeMode&gt;clampToGround&lt;/altitudeMode&gt;                   &lt;!-- or <em>absolute</em> --&gt;
         &lt;!-- can substitute <em>&lt;gx:altitudeMode&gt;clampToSeaFloor&lt;/gx:altitudeMode&gt;</em> --&gt;

  <strong>&lt;gx:LatLonQuad&gt;
    &lt;coordinates&gt;...&lt;/coordinates&gt;              &lt;!-- four lon,lat tuples --&gt;
  &lt;/gx:LatLonQuad&gt;</strong>
&lt;/GroundOverlay&gt;</pre>
<h3>Description</h3>
<p>Allows non-rectangular quadrilateral ground overlays.</p>
<p>Specifies the coordinates of the four corner points of a
quadrilateral defining the overlay area. Exactly four coordinate tuples
have to be provided, each consisting of floating point values for
longitude and latitude. Insert a space between tuples. Do not include
spaces within a tuple. The coordinates must be specified in
counter-clockwise order with the first coordinate corresponding to the
lower-left corner of the overlayed image. The shape described by these
corners must be convex.</p>
<p>If a third value is inserted into any tuple (representing altitude) it will be ignored. Altitude is set using <code>&lt;altitude&gt;</code> and <code>&lt;altitudeMode&gt;</code> (or <code>&lt;gx:altitudeMode&gt;</code>) extending <code>&lt;GroundOverlay&gt;</code>. Allowed altitude modes are <strong>absolute</strong>, <strong>clampToGround</strong>, and <strong>clampToSeaFloor</strong>.</p>
<h3>Example</h3>
<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>&lt;kml xmlns="http://www.opengis.net/kml/2.2"
<strong> xmlns:gx="http://www.google.com/kml/ext/2.2"</strong>&gt;
&lt;GroundOverlay&gt;
  &lt;name&gt;gx:LatLonQuad Example&lt;/name&gt;
  &lt;Icon&gt;
    &lt;href&gt;http://code.google.com/apis/kml/documentation/Images/rectangle.gif&lt;/href&gt;
    &lt;viewBoundScale&gt;0.75&lt;/viewBoundScale&gt;
  &lt;/Icon&gt;
  <strong>&lt;gx:LatLonQuad&gt;
    &lt;coordinates&gt;
      81.601884,44.160723 83.529902,43.665148 82.947737,44.248831 81.509322,44.321015
    &lt;/coordinates&gt;
  &lt;/gx:LatLonQuad&gt;</strong>
&lt;/GroundOverlay&gt;
&lt;/kml&gt;</pre>
<h3> Extends</h3>
<ul>
  <li><a href="#overlay">&lt;Object&gt;</a></li>
</ul>
<h3>Contained by</h3>
<ul>
  <li><a href="#groundoverlay">&lt;GroundOverlay&gt;</a></li>
</ul>
	
<a name="linearring"></a>
<h2>&lt;LinearRing&gt;</h2>
<h3>Syntax </h3>
<pre><strong>&lt;LinearRing id="ID"&gt;</strong>
  &lt;!-- specific to LinearRing --&gt;
  &lt;extrude&gt;0&lt;/extrude&gt;                       &lt;!-- boolean --&gt;
  &lt;tessellate&gt;0&lt;/tessellate&gt;                 &lt;!-- boolean --&gt;
  &lt;altitudeMode&gt;clampToGround&lt;/altitudeMode&gt; 
    &lt;!-- kml:altitudeModeEnum: clampToGround, relativeToGround, <em>or</em> absolute --&gt;
    &lt;!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor --&gt;
  &lt;coordinates&gt;<em>...</em>&lt;/coordinates&gt;             &lt;!-- lon,lat[,alt] tuples --&gt; 
<strong>&lt;/LinearRing&gt;</strong></pre>

<h3>Description</h3>
<p>Defines a closed line string, typically the outer boundary of a
Polygon. Optionally, a LinearRing can also be used as the inner
boundary of a Polygon to create holes in the Polygon. A Polygon can
contain multiple &lt;LinearRing&gt; elements used as inner boundaries.</p>
<p class="note"><span><strong>Note:</strong> In Google Earth, a Polygon with an &lt;altitudeMode&gt; of <em>clampToGround</em> follows the great circle; however, a LinearRing (by itself) with an &lt;altitudeMode&gt; of <em>clampToGround</em> follows lines of constant latitude.</span> </p>
<h3>Elements Specific to LinearRing</h3>
<dl>
  <dt><strong>&lt;extrude&gt;<a name="extrude" id="extrude"></a></strong></dt>
	<dd>Boolean
value. Specifies whether to connect the LinearRing to the ground. To
extrude this geometry, the altitude mode must be either <strong>relativeToGround</strong>, <strong>relativeToSeaFloor</strong>, or <strong>absolute</strong>.
Only the vertices of the LinearRing are extruded, not the center of the
geometry. The vertices are extruded toward the center of the Earth's
sphere. </dd>
  <dt><strong>&lt;tessellate&gt;<a name="tessellate" id="tessellate"></a></strong></dt>
  <dd>Boolean
value. Specifies whether to allow the LinearRing to follow the terrain.
To enable tessellation, the value for &lt;altitudeMode&gt; must be <strong>clampToGround</strong> or <strong>clampToSeaFloor</strong>.
Very large LinearRings should enable tessellation so that they follow
the curvature of the earth (otherwise, they may go underground and be
hidden).</dd>
   <dt><strong>&lt;altitudeMode&gt;<a name="altitudemode" id="altitudemode"></a></strong></dt>
   <dd>Specifies how <em>altitude</em> components in the &lt;coordinates&gt; element are interpreted. Possible values are
     <ul>
       <li><strong>clampToGround -</strong> (default) Indicates to ignore an altitude specification (for example, in the &lt;coordinates&gt; tag). </li>
       <li><strong>relativeToGround</strong>
- Sets the altitude of the element relative to the actual ground
elevation of a particular location. For example, if the ground
elevation of a location is exactly at sea level and the altitude for a
point is set to 9 meters, then the elevation for the icon of a point
placemark elevation is 9 meters with this mode. However, if the same
coordinate is set over a location where the ground elevation is 10
meters above sea level, then the elevation of the coordinate is 19
meters. A typical use of this mode is for placing telephone poles or a
ski lift.</li>
       <li><strong>absolute </strong>- Sets the altitude
of the coordinate relative to sea level, regardless of the actual
elevation of the terrain beneath the element. For example, if you set
the altitude of a coordinate to 10 meters with an <em>absolute</em>
altitude mode, the icon of a point placemark will appear to be at
ground level if the terrain beneath is also 10 meters above sea level.
If the terrain is 3 meters above sea level, the placemark will appear
elevated above the terrain by 7 meters. A typical use of this mode is
for aircraft placement.</li>
     </ul>
  </dd><dt>&lt;gx:altitudeMode&gt;</dt>
       <dd>A KML extension in the <a href="#kmlextensions">Google extension namespace</a>, allowing altitudes relative to the sea floor. Values are:
         <ul>
             <li><strong>relativeToSeaFloor</strong>
- Interprets the &lt;altitude&gt; as a value in meters above the sea
floor. If the point is above land rather than sea, the &lt;altitude&gt;
will be interpreted as being above the ground.</li>
           <li><strong>clampToSeaFloor</strong>
- The &lt;altitude&gt; specification is ignored, and the point will be
positioned on the sea floor. If the point is on land rather than at
sea, the point will be positioned on the ground.</li>
         </ul>
       </dd>
</dl>

<dt><strong>&lt;coordinates&gt; </strong><em>(required)</em> </dt>
	 <dd>Four or more  tuples, each consisting of floating point values for <em>longitude</em>, <em>latitude</em>, and <em>altitude</em>. The <em>altitude</em>
component is optional. Do not include spaces within a tuple. The last
coordinate must be the same as the first coordinate. Coordinates are
expressed in decimal degrees only. </dd>
<dl>

<h3>Example</h3>
<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>&lt;kml xmlns="http://www.opengis.net/kml/2.2"&gt;<br>&lt;Placemark&gt;<br>  &lt;name&gt;LinearRing.kml&lt;/name&gt;<br>  &lt;Polygon&gt;<br>    &lt;outerBoundaryIs&gt;<br>      <strong>&lt;LinearRing&gt;</strong><br>        &lt;coordinates&gt;
          -122.365662,37.826988,0 
          -122.365202,37.826302,0 
          -122.364581,37.82655,0 
          -122.365038,37.827237,0 
          -122.365662,37.826988,0 
        &lt;/coordinates&gt;<br>      <strong>&lt;/LinearRing&gt;</strong><br>    &lt;/outerBoundaryIs&gt;<br>  &lt;/Polygon&gt;<br>&lt;/Placemark&gt;<br>&lt;/kml&gt;</pre> 
				
<h3>Extends</h3>
<ul>
	<li><a href="#geometry">&lt;<em>Geometry</em>&gt;</a></li>
</ul>
       
<h3>Contained By</h3> 
<ul> 
  <li><a href="#multigeometry">&lt;MultiGeometry&gt;</a></li> 
  <li><a href="#placemark">&lt;Placemark&gt;</a></li>  
	<li><a href="#innerboundaryis">&lt;innerBoundaryIs&gt;</a></li>
	<li><a href="#outerboundaryis">&lt;outerBoundaryIs&gt;</a></li>
</ul> 
	
<a name="linestring"></a>
<h2>&lt;LineString&gt;</h2>
<h3>Syntax </h3>
<pre><strong>&lt;LineString id="ID"&gt;</strong>
  &lt;!-- specific to LineString --&gt;
  &lt;extrude&gt;0&lt;/extrude&gt;                   &lt;!-- boolean --&gt;
  &lt;tessellate&gt;0&lt;/tessellate&gt;             &lt;!-- boolean --&gt;
  &lt;altitudeMode&gt;clampToGround&lt;/altitudeMode&gt; 
      &lt;!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute --&gt;
        &lt;!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor --&gt;
			&lt;!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor --&gt;
  &lt;coordinates&gt;<em>...</em>&lt;/coordinates&gt;         &lt;!<em>-- </em>lon,lat[,alt] --&gt;
<strong>&lt;/LineString&gt;</strong></pre>

<h3>Description </h3>
<p>Defines a connected set of line segments. Use <a href="#linestyle">&lt;LineStyle&gt;</a>
to specify the color, color mode, and width of the line. When a
LineString is extruded, the line is extended to the ground, forming a
polygon that looks somewhat like a wall or fence. For extruded
LineStrings, the line itself uses the current LineStyle, and the
extrusion uses the current PolyStyle. See the <em><a href="http://code.google.com/intl/de/apis/kml/documentation/kml_tut.html">KML Tutorial</a> </em>for examples of LineStrings (or <em>paths</em>).</p>
    
<h3>Elements Specific to LineString</h3>
<dl>
  <dt><strong>&lt;extrude&gt;<a name="extrude" id="extrude"></a></strong></dt>
  <dd>Boolean
value. Specifies whether to connect the LineString to the ground. To
extrude a LineString, the altitude mode must be either <strong>relativeToGround</strong>, <strong>relativeToSeaFloor</strong>, or <strong>absolute</strong>. The vertices in the LineString are extruded toward the center of the Earth's sphere.</dd>
  <dt><strong>&lt;tessellate&gt;<a name="tessellate" id="tessellate"></a></strong></dt>
  <dd>Boolean
value. Specifies whether to allow the LineString to follow the terrain.
To enable tessellation, the altitude mode must be <strong>clampToGround</strong> or <strong>clampToSeaFloor</strong>.
Very large LineStrings should enable tessellation so that they follow
the curvature of the earth (otherwise, they may go underground and be
hidden). </dd>
  <dt><strong>&lt;altitudeMode&gt;<a name="altitudemode" id="altitudemode"></a></strong></dt>
  <dd>Specifies how <em>altitude</em> components in the &lt;coordinates&gt; element are interpreted. Possible values are
    <ul>
      <li><strong>clampToGround </strong>- (default) Indicates to ignore an altitude specification (for example, in the &lt;coordinates&gt; tag).</li>
      <li><strong>relativeToGround</strong>
- Sets the altitude of the element relative to the actual ground
elevation of a particular location. For example, if the ground
elevation of a location is exactly at sea level and the altitude for a
point is set to 9 meters, then the elevation for the icon of a point
placemark elevation is 9 meters with this mode. However, if the same
coordinate is set over a location where the ground elevation is 10
meters above sea level, then the elevation of the coordinate is 19
meters. A typical use of this mode is for placing telephone poles or a
ski lift.</li>
      <li><strong>absolute </strong>- Sets the altitude
of the coordinate relative to sea level, regardless of the actual
elevation of the terrain beneath the element. For example, if you set
the altitude of a coordinate to 10 meters with an <em>absolute</em>
altitude mode, the icon of a point placemark will appear to be at
ground level if the terrain beneath is also 10 meters above sea level.
If the terrain is 3 meters above sea level, the placemark will appear
elevated above the terrain by 7 meters. A typical use of this mode is
for aircraft placement.</li>
    </ul>
  </dd>
	<dt>&lt;gx:altitudeMode&gt;</dt>
		 <dd>A KML extension in the <a href="#kmlextensions">Google extension namespace</a>, allowing altitudes relative to the sea floor. Values are:
			 <ul>
					 <li><strong>relativeToSeaFloor</strong>
- Interprets the &lt;altitude&gt; as a value in meters above the sea
floor. If the point is above land rather than sea, the &lt;altitude&gt;
will be interpreted as being above the ground.</li>
				 <li><strong>clampToSeaFloor</strong>
- The &lt;altitude&gt; specification is ignored, and the point will be
positioned on the sea floor. If the point is on land rather than at
sea, the point will be positioned on the ground.</li>
			 </ul>
		 </dd>
    <dt><strong>&lt;coordinates&gt; </strong><em>(required)</em> </dt>
	  <dd>Two or more coordinate tuples, each  consisting of floating point values for <em>longitude</em>, <em>latitude</em>, and <em>altitude</em>. The <em>altitude</em> component is optional. Insert a space between tuples. Do not include spaces within a tuple.</dd>
</dl>
	
<h3>Example</h3>
<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>&lt;kml xmlns="http://www.opengis.net/kml/2.2"&gt;<br>&lt;Document&gt;<br>  &lt;name&gt;LineString.kml&lt;/name&gt;<br>  &lt;open&gt;1&lt;/open&gt;<br>  &lt;LookAt&gt;<br>    &lt;longitude&gt;-122.36415&lt;/longitude&gt;<br>    &lt;latitude&gt;37.824553&lt;/latitude&gt;<br>    &lt;altitude&gt;0&lt;/altitude&gt;<br>    &lt;range&gt;150&lt;/range&gt;<br>    &lt;tilt&gt;50&lt;/tilt&gt;<br>    &lt;heading&gt;0&lt;/heading&gt;<br>  &lt;/LookAt&gt;<br>  &lt;Placemark&gt;<br>    &lt;name&gt;unextruded&lt;/name&gt;<br>    &lt;LineString&gt;<br>      &lt;extrude&gt;1&lt;/extrude&gt;<br>      &lt;tessellate&gt;1&lt;/tessellate&gt;<br>      &lt;coordinates&gt;<br>        -122.364383,37.824664,0 -122.364152,37.824322,0 
      &lt;/coordinates&gt;<br>    &lt;/LineString&gt;<br>  &lt;/Placemark&gt;<br>  &lt;Placemark&gt;<br>    &lt;name&gt;extruded&lt;/name&gt;<br>    <strong>&lt;LineString&gt;</strong><br>      &lt;extrude&gt;1&lt;/extrude&gt;<br>      &lt;tessellate&gt;1&lt;/tessellate&gt;<br>      &lt;altitudeMode&gt;relativeToGround&lt;/altitudeMode&gt;<br>      &lt;coordinates&gt;<br>        -122.364167,37.824787,50 -122.363917,37.824423,50 
      &lt;/coordinates&gt;<br>    <strong>&lt;/LineString&gt;</strong><br>  &lt;/Placemark&gt;<br>&lt;/Document&gt;<br>&lt;/kml&gt;</pre>
			 
<h3>Extends</h3>
<ul>
  <li><a href="#geometry">&lt;<em>Geometry</em>&gt;</a></li>
</ul>
       
<h3>Contained By</h3> 
<ul> 
  <li><a href="#multigeometry">&lt;MultiGeometry&gt;</a></li> 
  <li><a href="#placemark">&lt;Placemark&gt;</a> </li> 
</ul>
	
<a name="linestyle"></a>
<h2>&lt;LineStyle&gt;</h2>
<h3>Syntax </h3>
<pre><strong>&lt;LineStyle id="ID"&gt;</strong>
  &lt;!-- inherited from <em>ColorStyle</em> --&gt;
  &lt;color&gt;ffffffff&lt;/color&gt;            &lt;!-- kml:color --&gt;
  &lt;colorMode&gt;normal&lt;/colorMode&gt;      &lt;!-- colorModeEnum: normal <em>or</em> random --&gt;

  &lt;!-- specific to LineStyle --&gt;
  &lt;width&gt;1&lt;/width&gt;                   &lt;!-- float --&gt;
<strong>&lt;/LineStyle&gt;</strong></pre>

<h3>Description</h3>
<p>Specifies the drawing style (color, color mode, and line width) for
all line geometry. Line geometry includes the outlines of outlined
polygons and the extruded "tether" of Placemark icons (if extrusion is
enabled).</p>
    
<h3>Elements Specific to LineStyle</h3>
  <dl>
    <dt><strong>&lt;width&gt;<a name="width" id="width"></a> </strong></dt>
	  <dd>Width of the line, in pixels.</dd>
	</dl>
	
<h3>Example</h3>
<p>The following example shows a 50 percent opaque red line with a width of 4 pixels.</p>
	<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>&lt;kml xmlns="http://www.opengis.net/kml/2.2"&gt;<br>&lt;Document&gt;<br>  &lt;name&gt;LineStyle.kml&lt;/name&gt;<br>  &lt;open&gt;1&lt;/open&gt;<br>  &lt;Style id="linestyleExample"&gt;<br>    <strong>&lt;LineStyle&gt;</strong><br>      &lt;color&gt;7f0000ff&lt;/color&gt;<br>      &lt;width&gt;4&lt;/width&gt;<br>    <strong>&lt;/LineStyle&gt;</strong><br>  &lt;/Style&gt;<br>  &lt;Placemark&gt;<br>    &lt;name&gt;LineStyle Example&lt;/name&gt;<br>    &lt;styleUrl&gt;#linestyleExample&lt;/styleUrl&gt;<br>    &lt;LineString&gt;<br>      &lt;extrude&gt;1&lt;/extrude&gt;<br>      &lt;tessellate&gt;1&lt;/tessellate&gt;<br>      &lt;coordinates&gt;<br>        -122.364383,37.824664,0 -122.364152,37.824322,0 
      &lt;/coordinates&gt;<br>    &lt;/LineString&gt;<br>  &lt;/Placemark&gt;<br>&lt;/Document&gt;<br>&lt;/kml&gt;</pre>
			 
<h3>Extends</h3>
<ul>
  <li><a href="#colorstyle">&lt;<em>ColorStyle</em>&gt;</a></li>
</ul>
       
<h3>Contained By</h3> 
<ul> 
  <li><a href="#style">&lt;Style&gt;</a></li>
</ul>
	
<a name="link"></a>
<h2>&lt;Link&gt;</h2>
<h3>Syntax </h3>
    <pre><strong>&lt;Link id="ID"&gt;</strong>
  &lt;!-- specific to Link --&gt;
  &lt;href&gt;<em>...</em>&lt;/href&gt;                      &lt;!-- <span>string</span> --&gt;
  &lt;refreshMode&gt;onChange&lt;/refreshMode&gt;   
    &lt;!-- refreshModeEnum: onChange, onInterval, <em>or</em> onExpire --&gt;   
  &lt;refreshInterval&gt;4&lt;/refreshInterval&gt;  &lt;!-- float --&gt;
  &lt;viewRefreshMode&gt;never&lt;/viewRefreshMode&gt; 
    &lt;!-- viewRefreshModeEnum: never, onStop, onRequest, onRegion --&gt;
  &lt;viewRefreshTime&gt;4&lt;/viewRefreshTime&gt;  &lt;!-- float --&gt;
  &lt;viewBoundScale&gt;1&lt;/viewBoundScale&gt;    &lt;!-- float --&gt;
  &lt;viewFormat&gt;BBOX=[bboxWest],[bboxSouth],[bboxEast],[bboxNorth]&lt;<strong>/</strong>viewFormat&gt;
                                        &lt;!-- string --&gt;
  &lt;httpQuery&gt;...&lt;/httpQuery&gt;            &lt;!-- string --&gt;
<strong>&lt;/Link&gt;</strong></pre>

    <h3>Description</h3>
<p>&lt;Link&gt; specifies the location of any of the following:</p>
  <ul>
    <li>KML files fetched by network links</li>
    <li>Image
files used in any Overlay (the &lt;Icon&gt; element specifies the image
in an Overlay; &lt;Icon&gt; has the same fields as &lt;Link&gt;)</li>
    <li>Model files used in the &lt;Model&gt; element</li>
  </ul>
<p>The file is conditionally loaded and refreshed, depending on the
refresh parameters supplied here. Two different sets of refresh
parameters can be specified: one set is based on <em>time</em> (&lt;refreshMode&gt; and &lt;refreshInterval&gt;) and one is based on the current "camera" <em>view</em>
(&lt;viewRefreshMode&gt; and &lt;viewRefreshTime&gt;). In addition,
Link specifies whether to scale the bounding box parameters that are
sent to the server (&lt;viewBoundScale&gt; and provides a set of
optional viewing parameters that can be sent to the server
(&lt;viewFormat&gt;) as well as a set of optional parameters containing
version and language information.</p>
<p>When a file is fetched, the URL that is sent to the server is composed of three pieces of information:</p>
  <ul>
    <li>the <em>href</em> (Hypertext Reference) that specifies the file to load.</li>
    <li>an <em>arbitrary format string</em>
that is created from (a) parameters that you specify in the
&lt;viewFormat&gt; element or (b) bounding box parameters (this is the
default and is used if no &lt;viewFormat&gt; element is included in the
file).</li>
    <li>a second <em>format string that is specified in the &lt;httpQuery&gt;</em> element.</li>
  </ul>
<p>If the file specified in &lt;href&gt; is a local file, the &lt;viewFormat&gt; and &lt;httpQuery&gt; elements are not used. </p>
<p>The &lt;Link&gt; element replaces the &lt;Url&gt; element of
&lt;NetworkLink&gt; contained in earlier KML releases and adds
functionality for the <a href="#region">&lt;Region&gt;</a> element (introduced in KML 2.1). In Google Earth releases 3.0 and earlier, the &lt;Link&gt; element is ignored.</p>

<h3>Elements Specific to Link </h3>
<dl>
  <dt><strong>&lt;href&gt; </strong><a name="href" id="href"></a> </dt>
	<dd>A
URL (either an HTTP address or a local file specification). When the
parent of &lt;Link&gt; is a NetworkLink, &lt;href&gt; is a KML file.
When the parent of &lt;Link&gt; is a Model, &lt;href&gt; is a COLLADA
file. When the parent of <a href="#icon">&lt;Icon&gt;</a> (same fields
as &lt;Link&gt;) is an Overlay, &lt;href&gt; is an image. Relative URLs
can be used in this tag and are evaluated relative to the enclosing KML
file.</dd>
	<dt><strong>&lt;refreshMode&gt;<a name="refreshmode" id="refreshmode"></a></strong></dt>
	<dd>Specifies a time-based refresh mode, which can be one of the following:
	   <ul>
      <li><strong>onChange</strong> - refresh when the file is loaded and whenever the Link parameters change (the default).</li>
      <li><strong>onInterval</strong> - refresh every <em>n</em> seconds (specified in <em>&lt;refreshInterval&gt;</em>).</li>
      <li><strong>onExpire</strong> - refresh the file when the expiration time is reached. <span>If a fetched file has a NetworkLinkControl,</span> the &lt;expires&gt; time takes precedence over expiration times specified in HTTP headers. If no <em>&lt;expires&gt;</em> time is specified, the HTTP <em>max-age</em> header is used (if present). If <em>max-age</em> is not present, the <em>Expires</em> HTTP header is used (if present). (See Section <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html">RFC261b</a> of the <em>Hypertext Transfer Protocol - HTTP 1.1</em> for details on HTTP header fields.)</li>
	  </ul>
	</dd>
	<dt><strong>&lt;refreshInterval&gt;<a name="refreshinterval" id="refreshinterval"></a></strong></dt>
	<dd>Indicates to refresh the file every <em>n</em> seconds.   </dd>
	<dt><strong>&lt;viewRefreshMode&gt;<a name="viewrefreshmode" id="viewrefreshmode"></a></strong></dt>
	<dd>Specifies how the link is refreshed when the "camera" changes.</dd>
	<dd>Can be one of the following: 
	  <ul>
	    <li><strong>never</strong>  (default) - Ignore changes in the view. Also ignore &lt;viewFormat&gt; parameters, if any.</li> 
	    <li><strong>onStop</strong> - Refresh the file <em>n</em> seconds after movement stops, where <em>n</em> is specified in &lt;viewRefreshTime&gt;.</li>
	    <li><strong>onRequest</strong>
- Refresh the file only when the user explicitly requests it. (For
example, in Google Earth, the user right-clicks and selects Refresh in
the Context menu.)</li>
	    <li><strong>onRegion</strong> - Refresh the file when the Region becomes active. See <a href="#region">&lt;Region&gt;</a>.</li>
    </ul>
  </dd>
	<dt><strong>&lt;viewRefreshTime&gt;<a name="viewrefreshtime" id="viewrefreshtime"></a></strong></dt>
	<dd>After
camera movement stops, specifies the number of seconds to wait before
refreshing the view. (See &lt;viewRefreshMode&gt; and <strong>onStop</strong> above.) </dd>
	<dt><strong>&lt;viewBoundScale&gt;<a name="viewboundscale" id="viewboundscale"></a></strong></dt>
	<dd>Scales
the BBOX parameters before sending them to the server. A value less
than 1 specifies to use less than the full view (screen). A value
greater than 1 specifies to fetch an area that extends beyond the edges
of the current view. </dd>
	<dt><strong>&lt;viewFormat&gt;<a name="viewformat" id="viewformat"></a></strong></dt>
	<dd>Specifies the format of the query string that is  appended to the Link's <a href="#href">&lt;href&gt;</a> before the file is fetched.(If the &lt;href&gt; specifies a local file, this element is ignored.)</dd>
	 <dd>If you specify a &lt;viewRefreshMode&gt; of <strong>onStop</strong>
and do not include the &lt;viewFormat&gt; tag in the file, the
following information is automatically appended to the query string:</dd>
		<blockquote>
	     <p><strong>BBOX=[bboxWest],[bboxSouth],[bboxEast],[bboxNorth]</strong></p>
    </blockquote>
    <dd>This information matches the Web Map Service (WMS) bounding box specification.</dd>
    <dd>If you specify an empty &lt;viewFormat&gt; tag, no information is appended to the query string.</dd>
    <dd>You can also specify a custom set of viewing parameters to add to the query string. If you supply a format string, it is used <span class="style1">instead of</span> the BBOX information. If you also want the BBOX information, you need to add those parameters along with the custom parameters.</dd>
    <dd>You
can use any of the following parameters in your format string (and
Google Earth will substitute the appropriate current value at the time
it creates the query string): <ul>
	     <li><strong>[lookatLon]</strong>, <strong>[lookatLat] </strong>- longitude and latitude of the point that &lt;LookAt&gt; is viewing </li> 
	     <li><strong>[lookatRange]</strong>,<strong> [lookatTilt]</strong>, <strong>[lookatHeading]</strong> - values used by the &lt;LookAt&gt; element (see descriptions of <a href="#range">&lt;range&gt;</a>, <a href="#tilt">&lt;tilt&gt;</a>, and <a href="#heading">&lt;heading&gt;</a> in <a href="#lookat">&lt;LookAt&gt;</a>)</li>
	     <li><span><strong>[lookatTerrainLon], [lookatTerrainLat], [lookatTerrainAlt]</strong> - point on the terrain in degrees/meters that &lt;LookAt&gt; is viewing </span></li>
       <li><strong>[cameraLon], [cameraLat], [cameraAlt]</strong> - degrees/meters of the eyepoint for the camera </li>
      <li><strong>[horizFov]</strong>, <strong>[vertFov] </strong>- horizontal, vertical field of view for the camera</li>    
	    <li><strong>[horizPixels]</strong>, <strong>[vertPixels]</strong> - size in pixels of the 3D viewer</li>
	    <li><strong>[terrainEnabled]</strong> - indicates whether the 3D viewer is showing terrain</li> 
     </ul>
	 </dd>
	 <dt><strong>&lt;httpQuery&gt;<a name="httpquery" id="httpquery"></a></strong></dt>
	 <dd>Appends
information to the query string, based on the parameters specified.
(Google Earth substitutes the appropriate current value at the time it
creates the query string.) The following parameters are supported: <ul>
	     <li><strong>[clientVersion]</strong></li>
	     <li><strong>[kmlVersion] </strong></li>
	     <li><strong>[clientName]</strong></li>
	     <li><strong>[language]</strong></li>
	   </ul>
	</dd>
</dl>

<h3>Example</h3>
     <pre>&lt;NetworkLink&gt;
  &lt;name&gt;NE US Radar&lt;/name&gt;
  &lt;flyToView&gt;1&lt;/flyToView&gt;
  <strong>&lt;Link&gt;</strong>
    &lt;href&gt;http://www.example.com/geotiff/NE/MergedReflectivityQComposite.kml&lt;/href&gt;
    &lt;refreshMode&gt;onInterval&lt;/refreshMode&gt;
    &lt;refreshInterval&gt;30&lt;/refreshInterval&gt;
    &lt;viewRefreshMode&gt;onStop&lt;/viewRefreshMode&gt;
    &lt;viewRefreshTime&gt;7&lt;/viewRefreshTime&gt;
    &lt;viewFormat&gt;BBOX=[bboxWest],[bboxSouth],[bboxEast],[bboxNorth];CAMERA=\
      [lookatLon],[lookatLat],[lookatRange],[lookatTilt],[lookatHeading];VIEW=\
      [horizFov],[vertFov],[horizPixels],[vertPixels],[terrainEnabled]&lt;/viewFormat&gt;
  <strong>&lt;/Link&gt;</strong>
&lt;/NetworkLink&gt; </pre>
 
<h3>Extends</h3>
<ul>
	 <li><a href="#object">&lt;<em>Object</em>&gt;</a></li>
</ul>
       
<h3>Contained By</h3> 
<ul> 
  <li><a href="#model">&lt;Model&gt;</a></li> 
  <li><a href="#networklink">&lt;NetworkLink&gt;</a></li>
</ul>
 
<h3>See Also</h3> 
<ul> 
  <li><a href="#networklinkcontrol">&lt;NetworkLinkControl&gt;</a></li>      
  <li><a href="#region">&lt;Region&gt;</a>
</li></ul>
	  
<a name="liststyle"></a>
<h2>&lt;ListStyle&gt;</h2>
<h3>Syntax </h3>
<pre><strong>&lt;ListStyle id="ID"&gt;</strong>
  &lt;!-- specific to ListStyle --&gt;
  &lt;listItemType&gt;check&lt;/listItemType&gt; &lt;!-- kml:listItemTypeEnum:check,
                                          checkOffOnly,checkHideChildren,
                                         radioFolder --&gt;
  &lt;bgColor&gt;ffffffff&lt;/bgColor&gt;        &lt;!-- kml:color --&gt;
  &lt;ItemIcon&gt;                         &lt;!-- 0 or more ItemIcon elements --&gt;
    &lt;state&gt;open&lt;/state&gt;   
      &lt;!-- kml:itemIconModeEnum:open, closed, error, fetching0, fetching1, <em>or</em> fetching2 --&gt;
    &lt;href&gt;...&lt;/href&gt;                 &lt;!-- anyURI --&gt;
  &lt;/ItemIcon&gt;
<strong>&lt;/ListStyle&gt;</strong></pre>

<h3>Description </h3>
<p>Specifies how a Feature is displayed in the list view. The <em>list view</em> is a hierarchy of containers and children; in Google Earth, this is the Places panel.</p>
    
<h3>Elements Specific to ListStyle</h3>
  <dl>
    <dt><strong>&lt;listItemType&gt; </strong><a name="listItemType" id="listItemType"></a> </dt>
	  <dd>Specifies how a Feature is displayed in the list view. Possible values are:
	    <ul>
	      <li><strong>check</strong> (default) - The Feature's visibility is tied to its item's checkbox.</li>
	      <li><strong>radioFolder</strong> - When specified for a Container, only one of the Container's items is visible at a time</li>
	      <li><strong>checkOffOnly</strong>
- When specified for a Container or Network Link, prevents all items
from being made visible at once—that is, the user can turn everything
in the Container or Network Link off but cannot turn everything on at
the same time. This setting is useful for Containers or Network Links
containing large amounts of data.<em><strong> </strong></em></li>
	      <li><strong>checkHideChildren</strong>
- Use a normal checkbox for visibility but do not display the Container
or Network Link's children in the list view. A checkbox allows the user
to toggle visibility of the child objects in the viewer.</li>
	    </ul>
	  </dd>
		<dt><strong>&lt;bgColor&gt;</strong><a name="bgcolor" id="bgcolor"></a></dt>
    <dd>Background
color for the Snippet. Color and opacity values are expressed in
hexadecimal notation. The range of values for any one color is 0 to 255
(<span class="code">00</span> to <span class="code">ff</span>). For alpha, <span class="code">00</span> is fully transparent and <span class="code">ff</span> is fully opaque. The order of expression is <em>aabbggrr, </em>where <em>aa=alpha</em> (00 to ff); <em>bb=blue</em> (00 to ff); <em>gg=green </em>(00 to ff); <em>rr=red</em>
(00 to ff). For example, if you want to apply a blue color with 50
percent opacity to an overlay, you would specify the following: <span class="code">&lt;color&gt;7fff0000&lt;/color&gt;</span>, where <em>alpha</em>=0x7f, <em>blue</em>=0xff, <em>green</em>=0x00, and <em>red</em>=0x00.</dd>
	  <dt><strong>&lt;ItemIcon&gt;<a name="itemicon" id="itemicon"></a></strong></dt>
	  <dd>Icon used in the List view that reflects the state of a Folder or Link fetch. Icons associated with the <strong>open</strong> and <strong>closed</strong> modes are used for Folders and Network Links.   Icons associated with the <strong>error</strong> and <strong>fetching0</strong><em>, </em><strong>fetching1</strong><em>, </em>and <strong>fetching2</strong> modes are used for Network Links. 
      The following screen capture illustrates the Google Earth icons for these states:    </dd>
	  <dd><img src="kmlreference22_ext-Dateien/itemicons.jpg" alt="" height="229" width="154"></dd>
	  <dd>
	    <dl>
	      <dt>&lt;state&gt;<a name="state" id="state"></a></dt>
				<dd>Specifies the current state of the NetworkLink or Folder.  Possible values are <strong>open</strong>, <strong>closed</strong>, <strong>error</strong>, <strong>fetching0</strong>, <strong>fetching1</strong>, and <strong>fetching2</strong>. These values can be combined by inserting a space between two values (no comma). </dd>
         <dt>&lt;href&gt;</dt>
				 <dd>Specifies the URI of the image used in the List View for the Feature. </dd>
      </dl>
    </dd>
  </dl>
	
<h3>Example</h3>
<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>&lt;kml xmlns="http://www.opengis.net/kml/2.2"&gt;<br>&lt;Document&gt;<br>  &lt;name&gt;ListStyle.kml&lt;/name&gt;<br>  &lt;open&gt;1&lt;/open&gt;<br>  &lt;Style id="bgColorExample"&gt;<br>    <strong>&lt;ListStyle&gt;</strong><br>      &lt;bgColor&gt;ff336699&lt;/bgColor&gt;<br>    <strong>&lt;/ListStyle&gt;</strong><br>  &lt;/Style&gt;<br>  &lt;Style id="checkHideChildrenExample"&gt;<br>    <strong>&lt;ListStyle&gt;</strong><br>      &lt;listItemType&gt;checkHideChildren&lt;/listItemType&gt;<br>    <strong>&lt;/ListStyle&gt;</strong><br>  &lt;/Style&gt;<br>  &lt;Style id="radioFolderExample"&gt;<br>    <strong>&lt;ListStyle&gt;</strong><br>      &lt;listItemType&gt;radioFolder&lt;/listItemType&gt;<br>    <strong>&lt;/ListStyle&gt;</strong><br>  &lt;/Style&gt;<br>  &lt;Folder&gt;<br>    &lt;name&gt;ListStyle Examples&lt;/name&gt;<br>    &lt;open&gt;1&lt;/open&gt;<br>    &lt;Folder&gt;<br>      &lt;name&gt;bgColor example&lt;/name&gt;<br>      &lt;open&gt;1&lt;/open&gt;<br>      &lt;Placemark&gt;<br>        &lt;name&gt;pl1&lt;/name&gt;<br>        &lt;Point&gt;<br>          &lt;coordinates&gt;-122.362815,37.822931,0&lt;/coordinates&gt;<br>        &lt;/Point&gt;<br>      &lt;/Placemark&gt;<br>      &lt;Placemark&gt;<br>        &lt;name&gt;pl2&lt;/name&gt;<br>        &lt;Point&gt;<br>          &lt;coordinates&gt;-122.362825,37.822931,0&lt;/coordinates&gt;<br>        &lt;/Point&gt;<br>      &lt;/Placemark&gt;<br>      &lt;Placemark&gt;<br>        &lt;name&gt;pl3&lt;/name&gt;<br>        &lt;Point&gt;<br>          &lt;coordinates&gt;-122.362835,37.822931,0&lt;/coordinates&gt;<br>        &lt;/Point&gt;<br>      &lt;/Placemark&gt;<br>      &lt;styleUrl&gt;#bgColorExample&lt;/styleUrl&gt;<br>    &lt;/Folder&gt;<br>    &lt;Folder&gt;<br>      &lt;name&gt;checkHideChildren example&lt;/name&gt;<br>      &lt;open&gt;1&lt;/open&gt;<br>      &lt;Placemark&gt;<br>        &lt;name&gt;pl4&lt;/name&gt;<br>        &lt;Point&gt;<br>          &lt;coordinates&gt;-122.362845,37.822941,0&lt;/coordinates&gt;<br>        &lt;/Point&gt;<br>      &lt;/Placemark&gt;<br>      &lt;Placemark&gt;<br>        &lt;name&gt;pl5&lt;/name&gt;<br>        &lt;Point&gt;<br>          &lt;coordinates&gt;-122.362855,37.822941,0&lt;/coordinates&gt;<br>        &lt;/Point&gt;<br>      &lt;/Placemark&gt;<br>      &lt;Placemark&gt;<br>        &lt;name&gt;pl6&lt;/name&gt;<br>        &lt;Point&gt;<br>          &lt;coordinates&gt;-122.362865,37.822941,0&lt;/coordinates&gt;<br>        &lt;/Point&gt;<br>      &lt;/Placemark&gt;<br>      &lt;styleUrl&gt;#checkHideChildrenExample&lt;/styleUrl&gt;<br>    &lt;/Folder&gt;<br>    &lt;Folder&gt;<br>      &lt;name&gt;radioFolder example&lt;/name&gt;<br>      &lt;open&gt;1&lt;/open&gt;<br>      &lt;Placemark&gt;<br>        &lt;name&gt;pl7&lt;/name&gt;<br>        &lt;Point&gt;<br>          &lt;coordinates&gt;-122.362875,37.822951,0&lt;/coordinates&gt;<br>        &lt;/Point&gt;<br>      &lt;/Placemark&gt;<br>      &lt;Placemark&gt;<br>        &lt;name&gt;pl8&lt;/name&gt;<br>        &lt;Point&gt;<br>          &lt;coordinates&gt;-122.362885,37.822951,0&lt;/coordinates&gt;<br>        &lt;/Point&gt;<br>      &lt;/Placemark&gt;<br>      &lt;Placemark&gt;<br>        &lt;name&gt;pl9&lt;/name&gt;<br>        &lt;Point&gt;<br>          &lt;coordinates&gt;-122.362895,37.822951,0&lt;/coordinates&gt;<br>        &lt;/Point&gt;<br>      &lt;/Placemark&gt;<br>      &lt;styleUrl&gt;#radioFolderExample&lt;/styleUrl&gt;<br>    &lt;/Folder&gt;<br>  &lt;/Folder&gt;<br>&lt;/Document&gt;<br>&lt;/kml&gt;</pre> 

<h3>Extends</h3>
<ul>
  <li><a href="#object">&lt;<em>Object</em>&gt;</a></li>
</ul>
       
<h3>Contained By</h3> 
<ul> 
  <li><a href="#style">&lt;Style&gt;</a> 
</li></ul> 
	  
<a name="lookat"></a>
<h2>&lt;LookAt&gt;</h2>
<h3>Syntax </h3> 
<pre><strong>&lt;LookAt id="ID"&gt;</strong>
  &lt;!-- inherited from AbstractView element --&gt;
  <em>&lt;TimePrimitive&gt;...&lt;/TimePrimitive&gt;</em>  &lt;!-- gx:TimeSpan or gx:TimeStamp --&gt;
   
  &lt;!-- specific to LookAt --&gt;
  &lt;longitude&gt;0&lt;/longitude&gt;            &lt;!-- kml:angle180 --&gt;
  &lt;latitude&gt;0&lt;/latitude&gt;              &lt;!-- kml:angle90 --&gt;
  &lt;altitude&gt;0&lt;/altitude&gt;              &lt;!-- double --&gt; 
  &lt;heading&gt;0&lt;/heading&gt;                &lt;!-- kml:angle360 --&gt;
  &lt;tilt&gt;0&lt;/tilt&gt;                      &lt;!-- kml:anglepos90 --&gt;
  &lt;range&gt;&lt;/range&gt;                     &lt;!-- double --&gt;
  &lt;altitudeMode&gt;clampToGround&lt;/altitudeMode&gt; 
          &lt;!--kml:altitudeModeEnum:clampToGround, relativeToGround, absolute --&gt;
          &lt;!-- or, gx:altitudeMode can be substituted: clampToSeaFloor, relativeToSeaFloor --&gt;

<strong>&lt;/LookAt&gt;</strong></pre>
	
<h3>Description</h3>
<p>Defines a virtual camera that is associated with any element derived
from Feature. The LookAt element positions the "camera" in relation to
the object that is being viewed. In Google Earth, the view "flies to"
this LookAt viewpoint when the user double-clicks an item in the Places
panel or double-clicks an icon in the 3D viewer.</p>

<h3>Elements Specific to LookAt</h3>
<dl>
  <dt><strong>&lt;longitude&gt;</strong></dt>
	<dd>Longitude of
the point the camera is looking at. Angular distance in degrees,
relative to the Prime Meridian. Values west of the Meridian range from
−180 to 0 degrees. Values east of the Meridian range from 0 to 180
degrees.</dd>
	<dt><strong>&lt;latitude&gt;</strong></dt>
	<dd>Latitude
of the point the camera is looking at. Degrees north or south of the
Equator (0 degrees). Values range from −90 degrees to 90 degrees.</dd>
	<dt><strong>&lt;altitude&gt;</strong></dt>
	<dd>Distance from the earth's surface, in meters. Interpreted according to the LookAt's altitude mode.</dd>
	<dt><strong>&lt;heading&gt;<a name="heading" id="heading"></a></strong></dt>
	<dd>Direction
(that is, North, South, East, West), in degrees. Default=0 (North).
(See diagram below.) Values range from 0 to 360 degrees. </dd>
	<dt><strong>&lt;tilt&gt;<a name="tilt" id="tilt"></a></strong></dt>
	<dd>Angle
between the direction of the LookAt position and the normal to the
surface of the earth. (See diagram below.) Values range from 0 to 90
degrees. Values for &lt;tilt&gt; cannot be negative. A &lt;tilt&gt;
value of 0 degrees indicates viewing from directly above. A
&lt;tilt&gt; value of 90 degrees indicates viewing along the horizon. </dd>
	<dt><strong>&lt;range&gt; </strong><em>(required)</em> <a name="range" id="range"></a></dt>
	<dd>Distance
in meters from the point specified by &lt;longitude&gt;,
&lt;latitude&gt;, and &lt;altitude&gt; to the LookAt position. (See
diagram below.) </dd>
	<dt><strong>&lt;altitudeMode&gt;</strong></dt>
	<dd>Specifies how the &lt;altitude&gt; specified for the LookAt point is interpreted. Possible values are as follows:
    <ul>
      <li><strong>clampToGround </strong>- (default) Indicates to ignore the &lt;altitude&gt; specification and place the LookAt position on the ground.</li>
      <li><strong>relativeToGround</strong> - Interprets the &lt;altitude&gt; as a value in meters above the ground.</li>
      <li><strong>absolute </strong>- Interprets the &lt;altitude&gt; as a value in meters above sea level.</li>
      </ul>
  </dd>
	<dt><a name="gxaltitudemode"></a>&lt;gx:altitudeMode&gt;</dt>
	<dd>A KML extension in the <a href="#kmlextensions">Google extension namespace</a>, allowing altitudes relative to the sea floor. Values are:
	  <ul>
	    <li><strong>relativeToSeaFloor</strong>
- Interprets the &lt;altitude&gt; as a value in meters above the sea
floor. If the point is above land rather than sea, the &lt;altitude&gt;
will be interpreted as being above the ground.</li>
        <li><strong>clampToSeaFloor</strong>
- The &lt;altitude&gt; specification is ignored, and the LookAt will be
positioned on the sea floor. If the point is on land rather than at
sea, the LookAt will be positioned on the ground.</li>
	  </ul>
	</dd>
</dl>
<p>This diagram illustrates the &lt;range&gt;, &lt;tilt&gt;, and &lt;altitude&gt;  elements:</p>
<img src="kmlreference22_ext-Dateien/lookAt.gif" alt="" height="298" width="500"> 
<p>&nbsp;</p>
<p>This diagram illustrates the &lt;heading&gt; element:<a name="headingdiagram" id="headingdiagram"></a></p>
<p>&nbsp; </p>
<img src="kmlreference22_ext-Dateien/heading.gif" alt="East=90, South=180, West=270" height="390" width="855">
	
<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;kml xmlns="http://www.opengis.net/kml/2.2"
xmlns:gx="http://www.google.com/kml/ext/2.2"&gt;

  &lt;Placemark&gt;
    &lt;name&gt;LookAt.kml&lt;/name&gt;
    <strong>&lt;LookAt&gt;</strong>
      &lt;gx:TimeStamp&gt;
        &lt;when&gt;1994&lt;/when&gt;
      &lt;/gx:TimeStamp&gt;
      &lt;longitude&gt;-122.363&lt;/longitude&gt;
      &lt;latitude&gt;37.81&lt;/latitude&gt;  
      &lt;altitude&gt;2000&lt;/altitude&gt;  
      &lt;range&gt;500&lt;/range&gt;   
      &lt;tilt&gt;45&lt;/tilt&gt; 
      &lt;heading&gt;0&lt;/heading&gt; 
      &lt;altitudeMode&gt;relativeToGround&lt;/altitudeMode&gt;
    <strong>&lt;/LookAt&gt;</strong> 
    &lt;Point&gt;   
      &lt;coordinates&gt;-122.363,37.82,0&lt;/coordinates&gt;
    &lt;/Point&gt;
  &lt;/Placemark&gt;
&lt;/kml&gt;</pre>

<h3>Extends</h3>
<ul>
	<li><a href="#abstractview"><span><u>&lt;<em>AbstractView</em>&gt;</u></span></a></li>
</ul>

<h3>Contained By</h3>
<ul>
<li>Any element derived from <a href="#feature">&lt;<em>Feature</em>&gt;</a></li>
<li><a href="#networklinkcontrol">&lt;NetworkLinkControl&gt;</a></li>
</ul>

<h2><a name="model"></a>&lt;Model&gt;</h2>
<h3>Syntax </h3>
<pre><strong>&lt;Model id="ID"&gt;</strong>
  &lt;!-- specific to Model --&gt;
  &lt;altitudeMode&gt;clampToGround&lt;/altitudeMode&gt; 
      &lt;!-- kml:altitudeModeEnum: clampToGround,relativeToGround,<em>or</em> absolute --&gt;
      &lt;!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor --&gt;
  &lt;Location&gt; 
    &lt;longitude&gt;&lt;/longitude&gt; &lt;!-- kml:angle180 --&gt;
    &lt;latitude&gt;&lt;/latitude&gt;   &lt;!-- kml:angle90 --&gt;  
    &lt;altitude&gt;0&lt;/altitude&gt;  &lt;!-- double --&gt; 
  &lt;/Location&gt; 
  &lt;Orientation&gt;               
    &lt;heading&gt;0&lt;/heading&gt;    &lt;!-- kml:angle360 --&gt;
    &lt;tilt&gt;0&lt;/tilt&gt;          &lt;!-- kml:angle360 --&gt;
    &lt;roll&gt;0&lt;/roll&gt;          &lt;!-- kml:angle360 --&gt;
  &lt;/Orientation&gt; 
  &lt;Scale&gt; 
    &lt;x&gt;1&lt;/x&gt;                &lt;!-- double --&gt;
    &lt;y&gt;1&lt;/y&gt;                &lt;!-- double --&gt;
    &lt;z&gt;1&lt;/z&gt;                &lt;!-- double --&gt;
  &lt;/Scale&gt; 
  &lt;Link&gt;...&lt;/Link&gt;
  <span>&lt;ResourceMap&gt;
    &lt;Alias&gt;
      &lt;targetHref&gt;...&lt;/targetHref&gt;   &lt;!-- anyURI --&gt;
      &lt;sourceHref&gt;...&lt;/sourceHref&gt;   &lt;!-- anyURI --&gt;
    &lt;/Alias&gt;
  &lt;/ResourceMap&gt;</span>
<strong>&lt;/Model&gt;</strong></pre>

<h3>Description </h3>
<p>A 3D object described in a COLLADA file (referenced in the <a href="#link">&lt;Link&gt;</a> tag). COLLADA files have a <em>.dae</em>
file extension. Models are created in their own coordinate space and
then located, positioned, and scaled in Google Earth. See the "Topics
in KML" page on <a href="http://code.google.com/intl/de/apis/kml/documentation/regions.html">Regions</a> for more detail.</p>
<p>Google Earth  supports the COLLADA common profile, with the following exceptions:</p>
  <ul>
    <li>Google Earth  supports only triangles and lines as primitive types. The maximum number of triangles allowed is 21845. </li>
    <li>Google Earth  does not support animation or skinning.</li>
    <li>Google Earth does not support external geometry references.</li>
  </ul>
	
<h3>Elements Specific to Model</h3>
<dl>
  <dt>&lt;altitudeMode&gt;</dt>
  <dd>Specifies how the &lt;altitude&gt; specified in &lt;Location&gt; is interpreted. Possible values are as follows:
    <ul>
      <li><strong>clampToGround </strong>- (default) Indicates to ignore the &lt;altitude&gt; specification and place the Model on the ground.</li>
      <li><strong>relativeToGround</strong> - Interprets the &lt;altitude&gt; as a value in meters above the ground. </li>
      <li><strong>absolute </strong>- Interprets the &lt;altitude&gt; as a value in meters above sea level. </li>
    </ul>
  </dd>
  <dt>&lt;gx:altitudeMode&gt;
      </dt>
  <dd>A KML extension in the <a href="#kmlextensions">Google extension namespace</a>, allowing altitudes relative to the sea floor. Values are:
    <ul>
        <li><strong>relativeToSeaFloor</strong>
- Interprets the &lt;altitude&gt; as a value in meters above the sea
floor. If the point is above land rather than sea, the &lt;altitude&gt;
will be interpreted as being above the ground.</li>
      <li><strong>clampToSeaFloor</strong>
- The &lt;altitude&gt; specification is ignored, and the Model will be
positioned on the sea floor. If the point is on land rather than at
sea, the Model will be positioned on the ground.</li>
    </ul>
  </dd>
  <dt>&lt;Location&gt;<a name="location" id="location"></a></dt>
  <dd>Specifies the exact coordinates of the Model's origin in latitude, longitude, and altitude. <strong>Latitude<a name="latitude" id="latitude"></a></strong> and <strong>longitude<a name="longitude" id="longitude"></a> </strong>measurements are standard lat-lon projection with WGS84 datum. <strong>Altitude</strong>
is distance above the earth's surface, in meters, and is interpreted
according to &lt;altitudeMode&gt; or &lt;gx:altitudeMode&gt;. <a name="altitude" id="altitude"></a>
      <pre><strong>&lt;Location&gt;</strong>
  &lt;longitude&gt;39.55375305703105&lt;/longitude&gt;  
  &lt;latitude&gt;-118.9813220168456&lt;/latitude&gt; 
  &lt;altitude&gt;1223&lt;/altitude&gt; 
<strong>&lt;/Location&gt;</strong> </pre>
  </dd>
     <dt><strong>&lt;Orientation&gt;<a name="orientation" id="orientation"></a> </strong> </dt>
	   <dd>Describes rotation of a 3D model's coordinate system to position the object in Google Earth. See diagram below. 
 <pre><strong>&lt;Orientation&gt;</strong> 
  &lt;heading&gt;45.0&lt;/heading&gt; 
  &lt;tilt&gt;10.0&lt;/tilt&gt; 
  &lt;roll&gt;0.0&lt;/roll&gt; 
<strong>&lt;/Orientation&gt;</strong> </pre>
</dd><dd>
<dl>
	  	    <dt>&lt;heading&gt;</dt><a name="heading" id="heading"></a> 
					<dd>Rotation about the <em>z</em> axis (normal to the Earth's surface). A value of 0 (the default) equals North.  A positive rotation is clockwise around the <em>z</em> axis and specified in degrees from 0 to 360.</dd>
	    <dt>&lt;tilt&gt;</dt><a name="tilt" id="tilt"></a>
			<dd>Rotation about the <em>x</em> axis. A positive rotation is clockwise around the <em>x</em> axis and specified in degrees from 0 to 360.</dd>
	    <dt>&lt;roll&gt;</dt> <a name="roll" id="roll"></a>
			<dd>Rotation about the <em>y</em> axis. A positive rotation is clockwise around the y axis and specified in degrees from 0 to 360.</dd>
		    <dd><img src="kmlreference22_ext-Dateien/orientationParams.gif" alt="heading, tilt, and roll are specified in a clockwise direction when looking down the axis toward the origin" height="326" width="672"></dd>
	    
	    <dd>This diagram illustrates the typical orientation of a model's axes:</dd>
	    <dd><img src="kmlreference22_ext-Dateien/modeling.gif" alt="For a typical model, +x is to the right, +y is to the front and oriented North, and +z is up" height="220" width="618"></dd>
</dl>
</dd>
	   <dt><strong>&lt;Scale<a name="scale2" id="scale2"></a>&gt;<a name="x" id="x"></a><a name="y" id="y"></a><a name="z" id="z"></a></strong></dt>
	   <dd>Scales a model along the <em>x</em>, <em>y</em>, and <em>z</em> axes in the model's coordinate space.	 
	<pre><strong>&lt;Scale&gt;</strong><br>  &lt;x&gt;2.5&lt;/x&gt;<br>  &lt;y&gt;2.5&lt;/y&gt;<br>  &lt;z&gt;3.5&lt;/z&gt;<br><strong>&lt;/Scale&gt;</strong></pre>
	   </dd>
     <dt><strong>&lt;Link&gt;</strong></dt>
	   <dd>Specifies the file to load and optional refresh parameters. See <a href="#link">&lt;Link&gt;</a>.</dd>
	   <dt><span><strong>&lt;ResourceMap&gt;<a name="resourcemap" id="resourcemap"></a></strong></span></dt>
	   <dd><span>Specifies 0 or more <strong>&lt;Alias&gt;</strong>
elements, each of which is a mapping for the texture file path from the
original Collada file to the KML or KMZ file that contains the Model.
This element allows you to move and rename texture files without having
to update the original Collada file that references those textures. One
&lt;ResourceMap&gt; element can contain multiple mappings from
different (source) Collada files into the same (target) KMZ file. </span>
<pre>&lt;Alias&gt;<br>  &lt;targetHref&gt;../images/foo.jpg&lt;/targetHref&gt;
  &lt;sourceHref&gt;c:\mytextures\foo.jpg&lt;/sourceHref&gt; 
&lt;/Alias&gt;</pre>
   </dd>

   <dt><span><strong>&lt;Alias&gt;<a name="alias" id="alias"></a></strong> contains a mapping from a &lt;sourceHref&gt; to a &lt;targetHref&gt;:</span></dt>
	 <dd>
	 <dl>
   <dt><span>&lt;targetHref&gt;<a name="targethref" id="targethref"></a></span></dt> 
	 <dd><span>Specifies
the texture file to be fetched by Google Earth. This reference can be a
relative reference to an image file within the <em>.kmz</em> archive, or it can be an absolute reference to the file (for example, a URL). </span></dd>
	 <dt><span>&lt;sourceHref&gt;<a name="sourcehref" id="sourcehref"></a></span></dt>
	 <dd>Is the path specified for the texture file in the Collada<em> .dae</em> file. <br>
	 </dd>
	 </dl>
   </dd>
	 <dd><span>In
Google Earth, if this mapping is not supplied, the following rules are
used to locate the textures referenced in the Collada (<em>.dae</em>) file:</span>
	    <ul>
        <li><span><strong><em>No path:</em></strong> If the texture name does not include a path, Google Earth looks for the texture in the same directory as the <em>.dae</em> file that references it.</span></li>
	      <li><span><em><strong>Relative path:</strong></em> If the texture name includes a relative path (for example,<em> ../images/mytexture.jpg</em>), Google Earth interprets the path as being relative to the <em>.dae</em> file that references it.</span></li>
	      <li><span><strong><em>Absolute path: </em></strong>If the texture name is an absolute path (<em>c:\mytexture.jpg</em>) or a network path (for example, <em>http://myserver.com/mytexture.jpg</em>), Google Earth looks for the file in the specified location, regardless of where the <em>.dae</em> file is located.</span> </li>
     </ul>
  </dd>
	
</dl>
	
<h3>Example</h3>
	<pre><strong>&lt;Model id="khModel543"&gt;</strong> <br>  &lt;altitudeMode&gt;relativeToGround&lt;/altitudeMode&gt; <br>  &lt;Location&gt; <br>    &lt;longitude&gt;39.55375305703105&lt;/longitude&gt; <br>    &lt;latitude&gt;-118.9813220168456&lt;/latitude&gt; <br>    &lt;altitude&gt;1223&lt;/altitude&gt; <br>  &lt;/Location&gt; <br>  &lt;Orientation&gt; <br>    &lt;heading&gt;45.0&lt;/heading&gt; <br>    &lt;tilt&gt;10.0&lt;/tilt&gt; <br>    &lt;roll&gt;0.0&lt;/roll&gt; <br>  &lt;/Orientation&gt; <br>  &lt;Scale&gt; <br>    &lt;x&gt;1.0&lt;/x&gt; <br>    &lt;y&gt;1.0&lt;/y&gt; <br>    &lt;z&gt;1.0&lt;/z&gt; <br>  &lt;/Scale&gt; <br>  &lt;Link&gt; <br>    &lt;href&gt;house.dae&lt;/href&gt; <br>    &lt;refreshMode&gt;once&lt;/refreshMode&gt; <br>  &lt;/Link&gt; <br>  &lt;ResourceMap&gt;<br>    &lt;Alias&gt;<br>      &lt;targetHref&gt;../files/CU-Macky---Center-StairsnoCulling.jpg&lt;/targetHref&gt;<br>      &lt;sourceHref&gt;CU-Macky---Center-StairsnoCulling.jpg&lt;/sourceHref&gt;<br>    &lt;/Alias&gt;<br>    &lt;Alias&gt;<br>      &lt;targetHref&gt;../files/CU-Macky-4sideturretnoCulling.jpg&lt;/targetHref&gt;<br>      &lt;sourceHref&gt;CU-Macky-4sideturretnoCulling.jpg&lt;/sourceHref&gt;<br>    &lt;/Alias&gt;<br>    &lt;Alias&gt;<br>      &lt;targetHref&gt;../files/CU-Macky-Back-NorthnoCulling.jpg&lt;/targetHref&gt;<br>      &lt;sourceHref&gt;CU-Macky-Back-NorthnoCulling.jpg&lt;/sourceHref&gt;<br>    &lt;/Alias&gt;<br>  &lt;/ResourceMap&gt;<br><strong>&lt;/Model&gt;</strong></pre>
	 
<h3>Extends</h3>
<ul>
	<li><a href="#geometry"><em>&lt;Geometry&gt;</em></a></li>
</ul>
       
<h3>Contained By</h3> 
<ul> 
  <li><a href="#multigeometry">&lt;MultiGeometry&gt;</a></li> 
  <li><a href="#placemark">&lt;Placemark&gt;</a></li>
</ul> 
	
<a name="multigeometry"></a>
<h2>&lt;MultiGeometry&gt;</h2>
<h3>Syntax </h3>
<pre><strong>&lt;MultiGeometry id="ID"&gt;</strong>
  &lt;!-- specific to MultiGeometry --&gt;
  &lt;!-- 0 or more <em>Geometry</em> elements --&gt;
<strong>&lt;/MultiGeometry&gt;</strong></pre>

<h3>Description </h3>
<p>A container for zero or more geometry primitives associated with the same feature.</p>
<p class="note"><strong>Note:</strong> The &lt;GeometryCollection&gt;<a name="geometrycollection" id="geometrycollection"></a> tag has been deprecated. Use &lt;MultiGeometry&gt; instead. </p>

<h3>Elements Specific to MultiGeometry </h3>
<ul>
  <li> 0 or more <a href="#geometry">&lt;Geometry&gt;</a> elements</li>
</ul>

<h3>Example</h3>
<pre>&lt;Placemark&gt;
  &lt;name&gt;SF Marina Harbor Master&lt;/name&gt;<br>  &lt;visibility&gt;0&lt;/visibility&gt;<br>  <strong>&lt;MultiGeometry&gt;</strong>
    &lt;LineString&gt;<br>      &lt;!-- north wall --&gt;
      &lt;coordinates&gt;<br>        -122.4425587930444,37.80666418607323,0<br>        -122.4428379594768,37.80663578323093,0
      &lt;/coordinates&gt;<br>    &lt;/LineString&gt;
    &lt;LineString&gt;<br>      &lt;!-- south wall --&gt;<br>      &lt;coordinates&gt;<br>        -122.4425509770566,37.80662588061205,0<br>        -122.4428340530617,37.8065999493009,0<br>      &lt;/coordinates&gt;
    &lt;/LineString&gt;<br>  <strong>&lt;/MultiGeometry&gt;</strong>
&lt;/Placemark&gt;</pre>

<h3>Extends</h3>
<ul>
  <li><a href="#geometry"><em>&lt;Geometry&gt;</em></a></li>
</ul>
	        
<h3>Contained By</h3> 
<ul> 
  <li><a href="#multigeometry">&lt;MultiGeometry&gt;</a></li> 
  <li><a href="#placemark">&lt;Placemark&gt;</a></li>
</ul>
	
<a name="networklink"></a>
<h2>&lt;NetworkLink&gt;</h2>
<h3>Syntax </h3>
<pre><strong>&lt;NetworkLink id="ID"&gt;</strong>
  &lt;!-- inherited from <em>Feature</em> element --&gt;&lt;name&gt;<em>...</em>&lt;/name&gt;                      &lt;!-- string --&gt;
  &lt;visibility&gt;1&lt;/visibility&gt;            &lt;!-- boolean --&gt;
  &lt;open&gt;0&lt;/open&gt;                        &lt;!-- boolean --&gt;
  <span>&lt;atom:author&gt;...&lt;atom:author&gt;         &lt;!-- xmlns:atom --&gt;
  &lt;atom:link&gt;...&lt;/atom:link&gt;</span><span>            &lt;!-- xmlns:atom --&gt;</span>
  &lt;address&gt;<em>...</em>&lt;/address&gt;                &lt;!-- string --&gt;
  &lt;xal:AddressDetails&gt;...&lt;/xal:AddressDetails&gt;  &lt;!-- xmlns:xal --&gt;<br>  &lt;phoneNumber&gt;...&lt;/phoneNumber&gt;        &lt;!-- string --&gt;<br>  &lt;Snippet maxLines="2"&gt;<em>...</em>&lt;/Snippet&gt;   &lt;!-- string --&gt;
  &lt;description&gt;<em>...</em>&lt;/description&gt;        &lt;!-- string --&gt;
  <span><em>&lt;AbstractView&gt;...&lt;/AbstractView&gt;</em>      &lt;!-- Camera <em>or</em> LookAt --&gt;</span>
  &lt;<em>TimePrimitive</em>&gt;...&lt;/<em>TimePrimitive</em>&gt;
  &lt;styleUrl&gt;<em>...</em>&lt;/styleUrl&gt;              &lt;!-- anyURI --&gt;
  &lt;<em>StyleSelector&gt;...&lt;/StyleSelector&gt;</em>
  &lt;Region&gt;...&lt;/Region&gt;
  <span>&lt;Metadata&gt;...&lt;/Metadata&gt;              &lt;!-- deprecated in KML 2.2 --&gt;
  &lt;ExtendedData&gt;...&lt;/ExtendedData&gt;      &lt;!-- new in KML 2.2 --&gt;</span>

  &lt;!-- specific to NetworkLink --&gt;
  &lt;refreshVisibility&gt;0&lt;/refreshVisibility&gt; &lt;!-- boolean --&gt;
  &lt;flyToView&gt;0&lt;/flyToView&gt;                 &lt;!-- boolean --&gt;
  &lt;Link&gt;...&lt;/Link&gt;
<strong>&lt;/NetworkLink&gt;</strong></pre>

<h3>Description</h3>
<p>References a  KML file or KMZ archive on a local or remote network. Use the <a href="#link">&lt;Link&gt;</a>
element to specify the location of the KML file. Within that element,
you can define the refresh options for updating the file, based on time
and camera change. NetworkLinks can be used in combination with Regions
to handle very large datasets efficiently.</p>
    
<h3>Elements Specific to NetworkLink </h3>
<dl>

<dt><strong>&lt;refreshVisibility<a name="refreshvisibility" id="refreshvisibility"></a>&gt;</strong></dt>
<dd>Boolean value. A value of 0 leaves the visibility of features
within the control of the Google Earth user. Set the value to 1 to
reset the visibility of features each time the NetworkLink is
refreshed. For example, suppose a Placemark within the linked KML file
has &lt;visibility&gt; set to 1 and the NetworkLink has
&lt;refreshVisibility&gt; set to 1. When the file is first loaded into
Google Earth, the user can clear the check box next to the item to turn
off display in the 3D viewer. However, when the NetworkLink is
refreshed, the Placemark will be made visible again, since its original
visibility state was TRUE. </dd>
<dt><strong>&lt;flyToView<a name="flytoview" id="flytoview"></a>&gt;</strong></dt>
<dd>Boolean value. A value of 1 causes Google Earth to fly to the view
of the LookAt or Camera in the NetworkLinkControl (if it exists). If
the NetworkLinkControl does not contain an AbstractView element, Google
Earth flies to the LookAt or Camera element in the Feature child within
the &lt;kml&gt; element in the refreshed file. If the &lt;kml&gt;
element does not have a LookAt or Camera specified, the view is
unchanged. For example, Google Earth would fly to the &lt;LookAt&gt;
view of the parent Document, not the &lt;LookAt&gt; of the Placemarks
contained within the Document.</dd>
<dt><strong>&lt;Link&gt; </strong><em>(required). </em>See <a href="#link">&lt;Link&gt;</a>. </dt>
<p class="note"><span><b>Tip:</b> To display the top-level Folder or
Document within a Network Link in the List View, assign an ID to the
Folder or Document. Without this ID, only the child object names are
displayed in the List View.</span></p>
</dl>

<h3>Example</h3>
<pre>&lt;Document&gt;
  &lt;visibility&gt;1&lt;/visibility&gt;
  <strong>&lt;NetworkLink&gt;</strong>
    &lt;name&gt;NE US Radar&lt;/name&gt;
    &lt;refreshVisibility&gt;1&lt;/refreshVisibility&gt;
    &lt;flyToView&gt;1&lt;/flyToView&gt;
    &lt;Link&gt;...&lt;/Link&gt;<strong>&lt;/NetworkLink&gt;</strong>
&lt;/Document&gt;</pre>
 
<h3>Extends</h3>
<ul>
  <li><a href="#feature">&lt;<em>Feature</em>&gt;</a></li>
</ul>
 
<h3>Contained By </h3>
<ul>
  <li>any element derived from <a href="#container">&lt;<em>Container</em>&gt;</a></li>
</ul> 
	  
<a name="networklinkcontrol"></a>
<h2>&lt;NetworkLinkControl&gt;</h2>
<h3>Syntax </h3>
<pre><strong>&lt;NetworkLinkControl&gt;</strong>
  &lt;minRefreshPeriod&gt;0&lt;/minRefreshPeriod&gt;           &lt;!-- float --&gt;
  <span class="style2">&lt;maxSessionLength&gt;-1&lt;/maxSessionLength&gt;          &lt;!-- float --&gt; </span>
  &lt;cookie&gt;<em>...</em>&lt;/cookie&gt;                             &lt;!-- string --&gt;                             
  &lt;message&gt;<em>...</em>&lt;/message&gt;                           &lt;!-- string --&gt;
  &lt;linkName&gt;<em>...</em>&lt;/linkName&gt;                         &lt;!-- string --&gt;                          
  &lt;linkDescription&gt;<em>...</em>&lt;/linkDescription&gt;           &lt;!-- string --&gt;              
  &lt;linkSnippet maxLines="2"&gt;<em>...</em>&lt;/linkSnippet&gt;      &lt;!-- string --&gt;                      
  &lt;expires&gt;...&lt;/expires&gt;                           &lt;!-- kml:dateTime --&gt;
  &lt;Update&gt;...&lt;/Update&gt;                             &lt;!-- Change,Create,Delete --&gt;
  <span><em>&lt;AbstractView&gt;...&lt;/AbstractView&gt;</em>                 &lt;!-- LookAt <em>or</em> Camera --&gt;</span>
<strong>&lt;/NetworkLinkControl&gt;</strong></pre>

<h3>Description</h3>
<p>Controls the behavior of files fetched by a <a href="#networklink">&lt;NetworkLink&gt;</a>.</p>
 
<h3>Elements Specific to NetworkLinkControl</h3>
<dl> 
  <dt>&lt;minRefreshPeriod&gt;<a name="minrefreshperiod" id="minrefreshperiod"></a></dt>
	<dd>Specified
in seconds, &lt;minRefreshPeriod&gt; is the minimum allowed time
between fetches of the file. This parameter allows servers to throttle
fetches of a particular file and to tailor refresh rates to the
expected rate of change to the data. For example, a user might set a
link refresh to 5 seconds, but you could set your minimum refresh
period to 3600 to limit refresh updates to once every hour.</dd> 
	<dt><span><strong>&lt;maxSessionLength&gt;<a name="maxsessionlength" id="maxsessionlength"></a></strong></span></dt>
	<dd><span>Specified
in seconds, &lt;maxSessionLength&gt; is the maximum amount of time for
which the client NetworkLink can remain connected. The default value of
-1 indicates not to terminate the session explicitly.</span></dd>
  <dt><strong>&lt;cookie&gt;<a name="cookie" id="cookie"></a></strong></dt>
	<dd>Use this <a href="#cookie"></a>
element to append a string to the URL query on the next refresh of the
network link. You can use this data in your script to provide more
intelligent handling on the server side, including version querying and
conditional file delivery.</dd> 
	<dt><strong>&lt;message&gt;<a name="message" id="message"></a></strong></dt>
	<dd>You
can deliver a pop-up message, such as usage guidelines for your network
link. The message appears when the network link is first loaded into
Google Earth, or when it is changed in the network link control. </dd> 
  <dt><strong>&lt;linkName&gt;<a name="linkname" id="linkname"></a></strong></dt>
	<dd>You
can control the name of the network link from the server, so that
changes made to the name on the client side are overridden by the
server.</dd> 
	<dt><strong>&lt;linkDescription&gt;<a name="linkdescription" id="linkdescription"></a></strong></dt>
	<dd>You
can control the description of the network link from the server, so
that changes made to the description on the client side are overridden
by the server.</dd>
  <dt><strong>&lt;linkSnippet </strong>maxLines="2" <strong>&gt;<a name="linksnippet" id="linksnippet"></a></strong></dt>
	<dd>You
can control the snippet for the network link from the server, so that
changes made to the snippet on the client side are overridden by the
server. &lt;linkSnippet&gt; has a <strong>maxLines</strong> attribute, an integer that specifies the maximum number of lines to display.</dd>
	<dt><strong>&lt;expires&gt;<a name="expires" id="expires"></a></strong></dt>
	<dd>You
can specify a date/time at which the link should be refreshed. This
specification takes effect only if the &lt;refreshMode&gt; in
&lt;Link&gt; has a value of <strong>onExpire</strong>. See <a href="#refreshmode">&lt;refreshMode&gt;</a></dd>
	<dt><strong>&lt;Update&gt;</strong></dt>
	<dd>With <a href="#update">&lt;Update&gt;</a>, you can specify any number of Change, Create, and Delete tags for a <em>.kml</em> file or <em>.kmz</em> archive that has previously been loaded with a network link. See <a href="#update">&lt;Update&gt;</a>. </dd>
  <dt><strong><a href="#abstractview">&lt;AbstractView&gt;</a></strong></dt>
</dl>

<h3>Example</h3>
<pre><strong>&lt;kml xmlns="http://www.opengis.net/kml/2.2"&gt;
&lt;NetworkLinkControl&gt;
   </strong>&lt;message&gt;This is a pop-up message. You will only see this once&lt;/message&gt;
   &lt;cookie&gt;cookie=sometext&lt;/cookie&gt;
   &lt;linkName&gt;New KML features&lt;/linkName&gt;
   &lt;linkDescription&gt;&lt;![CDATA[KML now has new features available!]]&gt;&lt;/linkDescription&gt;
<strong>&lt;/NetworkLinkControl&gt;</strong>
&lt;/kml&gt;</pre>

<h3>Extends</h3>
<ul>
	<li>This is a direct child of the &lt;kml&gt; element.</li>
</ul>
       
<h3>Contained By</h3> 
<ul> 
  <li>&lt;kml&gt;</li>      
</ul>
 
<h3>See Also</h3> 
<ul> 
  <li><a href="#update">&lt;Update&gt;</a></li>      
  <li><a href="#networklink">&lt;NetworkLink&gt;</a></li>
</ul> 
	
<a name="object"></a>
<h2>&lt;<em>Object</em>&gt;</h2>
<h3>Syntax </h3>
<pre>&lt;!-- abstract element; do not create --&gt;<strong>
&lt;!-- <em>Object</em> id="ID" targetId="NCName" --&gt;
&lt;!-- /<em>Object</em>&gt; --&gt;</strong></pre>

<h3>Description </h3>
<p>This is an abstract base class and cannot be used directly in a KML file. It provides the <strong>id</strong> attribute, which allows unique identification of a KML element, and the <strong>targetId</strong> attribute, which is used to reference objects that have already been loaded into Google Earth.  The <strong>id</strong> attribute must be assigned if the <a href="#update">&lt;Update&gt;</a> mechanism is to be used.</p>
    
<a name="overlay"></a>
<h2>&lt;<em>Overlay</em>&gt; </h2>
<h3>Syntax </h3> 
	<pre>&lt;!-- abstract element; do not create --&gt;
<strong>&lt;!-- <em>Overlay</em> id="ID" --&gt;</strong>                    &lt;!-- GroundOverlay,ScreenOverlay --&gt;
  &lt;!-- inherited from <em>Feature</em> element --&gt;
  &lt;name&gt;<em>...</em>&lt;/name&gt;                      &lt;!-- string --&gt;
  &lt;visibility&gt;1&lt;/visibility&gt;            &lt;!-- boolean --&gt;
  &lt;open&gt;0&lt;/open&gt;                        &lt;!-- boolean --&gt;
  <span>&lt;atom:author&gt;...&lt;atom:author&gt;         &lt;!-- xmlns:atom --&gt;
  &lt;atom:link&gt;...&lt;/atom:link&gt;</span><span>            &lt;!-- xmlns:atom --&gt;</span>
  &lt;address&gt;<em>...</em>&lt;/address&gt;                &lt;!-- string --&gt;
  &lt;xal:AddressDetails&gt;...&lt;/xal:AddressDetails&gt;  &lt;!-- xmlns:xal --&gt;<br>  &lt;phoneNumber&gt;...&lt;/phoneNumber&gt;        &lt;!-- string --&gt;<br>  &lt;Snippet maxLines="2"&gt;<em>...</em>&lt;/Snippet&gt;   &lt;!-- string --&gt;
  &lt;description&gt;<em>...</em>&lt;/description&gt;        &lt;!-- string --&gt;
  <span><em>&lt;AbstractView&gt;...&lt;/AbstractView&gt;</em>      &lt;!-- Camera <em>or</em> LookAt --&gt;</span>
  &lt;<em>TimePrimitive</em>&gt;...&lt;/<em>TimePrimitive</em>&gt;
  &lt;styleUrl&gt;<em>...</em>&lt;/styleUrl&gt;              &lt;!-- anyURI --&gt;
  &lt;<em>StyleSelector&gt;...&lt;/StyleSelector&gt;</em>
  &lt;Region&gt;...&lt;/Region&gt;
  <span>&lt;Metadata&gt;...&lt;/Metadata&gt;              &lt;!-- deprecated in KML 2.2 --&gt;
  &lt;ExtendedData&gt;...&lt;/ExtendedData&gt;      &lt;!-- new in KML 2.2 --&gt;</span>

  &lt;!-- specific to <em>Overlay</em> --&gt;
  &lt;color&gt;ffffffff&lt;/color&gt;                   &lt;!-- kml:color --&gt;
  &lt;drawOrder&gt;0&lt;/drawOrder&gt;                  &lt;!-- int --&gt;
  &lt;Icon&gt;
    &lt;href&gt;...&lt;/href&gt;
  &lt;/Icon&gt;
<strong>&lt;!-- /<em>Overlay --</em>&gt;</strong></pre>

  <h3>Description</h3>
<p>This is an abstract element and cannot be used directly in a KML file. &lt;<em>Overlay</em>&gt;
is the base type for image overlays drawn on the planet surface or on
the screen. &lt;Icon&gt; specifies the image to use and can be
configured to reload images based on a timer or by camera changes. This
element also includes specifications for stacking order of multiple
overlays and for adding color and transparency values to the base image.</p>

<h3>Elements Specific to Overlay</h3>
<dl>
  <dt><strong>&lt;color&gt;<a name="color" id="color"></a></strong></dt>
	<dd>Color
values are expressed in hexadecimal notation, including opacity (alpha)
values. The order of expression is alpha, blue, green, red (<em>aabbggrr</em>). The range of values for any one color is 0 to 255 (<span class="code">00</span> to <span class="code">ff).</span> For opacity, <span class="code">00</span> is fully transparent and <span class="code">ff</span>
is fully opaque. For example, if you want to apply a blue color with 50
percent opacity to an overlay, you would specify the following: <span class="code">&lt;color&gt;7fff0000&lt;/color&gt;</span></dd>
	<p class="note"><strong>Note: </strong>The &lt;geomColor&gt; element has been deprecated. Use &lt;color&gt; instead. <a name="geomcolor" id="geomcolor"></a></p>
	<dt><strong>&lt;drawOrder&gt; </strong><a name="draworder" id="draworder"></a></dt>
	<dd>
This element defines the stacking order for the images in overlapping
overlays. Overlays with higher &lt;drawOrder&gt; values are drawn on
top of overlays with lower &lt;drawOrder&gt; values.</dd>
	<dt><strong>&lt;Icon&gt; </strong>See also <a href="#icon">&lt;Icon&gt;</a>. </dt>
	<dd>Defines
the image associated with the Overlay. The &lt;href&gt; element defines
the location of the image to be used as the Overlay. This location can
be either on a local file system or on a web server. If this element is
omitted or contains no &lt;href&gt;, a rectangle is drawn using the
color and size defined by the ground or screen overlay. <pre><strong>&lt;Icon&gt;</strong>
   &lt;href&gt;icon.jpg&lt;/href&gt;
<strong>&lt;/Icon&gt;</strong></pre>
  </dd>
</dl>
	
<h3>Extends</h3>
<ul>
	<li><a href="#feature"><em>&lt;Feature&gt;</em></a></li>
</ul>

<h3>Extended By</h3>
<ul>
	<li><a href="#groundoverlay">&lt;GroundOverlay&gt;</a></li>
	<li><a href="#photooverlay">&lt;PhotoOverlay</a>&gt;</li>
	<li><a href="#screenoverlay">&lt;ScreenOverlay&gt;</a></li>
</ul> 
		
<h2>&lt;PhotoOverlay&gt;<a name="photooverlay" id="photooverlay" class="anchor"></a><span></span></h2>
<p><strong>Syntax </strong></p>
<pre>&lt;PhotoOverlay&gt;
  &lt;!-- inherited from <em>Feature</em> element --&gt;
  &lt;name&gt;<em>...</em>&lt;/name&gt;                      &lt;!-- string --&gt;
  &lt;visibility&gt;1&lt;/visibility&gt;            &lt;!-- boolean --&gt;
  &lt;open&gt;0&lt;/open&gt;                        &lt;!-- boolean --&gt;
  <span>&lt;atom:author&gt;...&lt;atom:author&gt;         &lt;!-- xmlns:atom --&gt;
  &lt;atom:link&gt;...&lt;/atom:link&gt;</span><span>            &lt;!-- xmlns:atom --&gt;</span>
  &lt;address&gt;<em>...</em>&lt;/address&gt;                &lt;!-- string --&gt;
  &lt;xal:AddressDetails&gt;...&lt;/xal:AddressDetails&gt;  &lt;!-- xmlns:xal --&gt;<br>  &lt;phoneNumber&gt;...&lt;/phoneNumber&gt;        &lt;!-- string --&gt;<br>  &lt;Snippet maxLines="2"&gt;<em>...</em>&lt;/Snippet&gt;   &lt;!-- string --&gt;
  &lt;description&gt;<em>...</em>&lt;/description&gt;        &lt;!-- string --&gt;
  <span><em>&lt;AbstractView&gt;...&lt;/AbstractView&gt;</em>      &lt;!-- Camera <em>or</em> LookAt --&gt;</span>
  &lt;<em>TimePrimitive</em>&gt;...&lt;/<em>TimePrimitive</em>&gt;
  &lt;styleUrl&gt;<em>...</em>&lt;/styleUrl&gt;              &lt;!-- anyURI --&gt;
  &lt;<em>StyleSelector&gt;...&lt;/StyleSelector&gt;</em>
  &lt;Region&gt;...&lt;/Region&gt;
  <span>&lt;Metadata&gt;...&lt;/Metadata&gt;              &lt;!-- deprecated in KML 2.2 --&gt;
  &lt;ExtendedData&gt;...&lt;/ExtendedData&gt;      &lt;!-- new in KML 2.2 --&gt;</span>

  &lt;!-- inherited from <em>Overlay</em> element --&gt;   
  &lt;color&gt;ffffffff&lt;/color&gt;               &lt;!-- kml:color --&gt;   
  &lt;drawOrder&gt;0&lt;/drawOrder&gt;              &lt;!-- int --&gt;     
  &lt;Icon&gt;
    &lt;href&gt;...&lt;/href&gt;                    &lt;!-- anyURI --&gt;
    ...
  &lt;/Icon&gt;         

  &lt;!-- specific to PhotoOverlay --&gt;
  &lt;rotation&gt;0&lt;/rotation&gt;                &lt;!-- kml:angle180 --&gt;
  &lt;ViewVolume&gt;
    &lt;leftFov&gt;0&lt;/leftFov&gt;                &lt;!-- kml:angle180 --&gt;
    &lt;rightFov&gt;0&lt;/rightFov&gt;              &lt;!-- kml:angle180 --&gt;
    &lt;bottomFov&gt;0&lt;/bottomFov&gt;            &lt;!-- kml:angle90 --&gt;
    &lt;topFov&gt;0&lt;/topFov&gt;                  &lt;!-- kml:angle90 --&gt;
    &lt;near&gt;0&lt;/near&gt;                      &lt;!-- double --&gt;
  &lt;/ViewVolume&gt;
  &lt;ImagePyramid&gt;
    &lt;tileSize&gt;256&lt;/tileSize&gt;            &lt;!-- int --&gt;
    &lt;maxWidth&gt;...&lt;/maxWidth&gt;            &lt;!-- int --&gt;
    &lt;maxHeight&gt;...&lt;/maxHeight&gt;          &lt;!-- int --&gt;
    &lt;gridOrigin&gt;lowerLeft&lt;/gridOrigin&gt; &lt;!-- lowerLeft or upperLeft --&gt;
  &lt;/ImagePyramid&gt;
  &lt;Point&gt;
    &lt;coordinates&gt;...&lt;/coordinates&gt;      &lt;!-- lon,lat[,alt] --&gt;
  &lt;/Point&gt;
  &lt;shape&gt;rectangle&lt;/shape&gt;               &lt;!-- kml:shape --&gt;
&lt;/PhotoOverlay&gt;
</pre>
	    
    <h3>Description </h3>
<p>The &lt;PhotoOverlay&gt; element allows you to geographically locate
a photograph on the Earth and to specify viewing parameters for this
PhotoOverlay. The PhotoOverlay can be a simple 2D rectangle, a partial
or full cylinder, or a sphere (for spherical panoramas). The overlay is
placed at the specified location and oriented toward the viewpoint.</p>
<p>Because &lt;PhotoOverlay&gt; is derived from &lt;Feature&gt;, it can
contain one of the two elements derived from
&lt;AbstractView&gt;—either &lt;Camera&gt; or &lt;LookAt&gt;. The
Camera (or LookAt) specifies a <em>viewpoint</em> and a <em>viewing direction</em> (also referred to as a <em>view vector</em>).
The PhotoOverlay is positioned in relation to the viewpoint.
Specifically, the plane of a 2D rectangular image is orthogonal (at
right angles to) the view vector. The normal of this plane—that is, its
front, which is the part with the photo—is oriented toward the
viewpoint.</p>
<p>The URL for the PhotoOverlay image is specified in the &lt;Icon&gt;
tag, which is inherited from &lt;Overlay&gt;. The &lt;Icon&gt; tag must
contain an &lt;href&gt; element that specifies the image file to use
for the PhotoOverlay. In the case of a very large image, the
&lt;href&gt; is a special URL that indexes into a pyramid of images of
varying resolutions (see <a href="#imagepyramid">ImagePyramid</a>).</p>
<p>For more information, see the "Topics in KML" page on <a href="http://code.google.com/intl/de/apis/kml/documentation/photos.html">PhotoOverlay</a>. </p>
<h3>Elements Specific to PhotoOverlay </h3>
<dl>
<dt><strong>&lt;rotation&gt;</strong></dt>
		<dd>Adjusts how the photo
is placed inside the field of view. This element is useful if your
photo has been rotated and deviates slightly from a desired horizontal
view.</dd>	  
  
  <dt><strong>&lt;ViewVolume&gt;</strong><a name="viewvolume" id="viewvolume"></a></dt>
	<dd>Defines how much of the current scene is visible. Specifying the <em>field of view</em>
is analogous to specifying the lens opening in a physical camera. A
small field of view, like a telephoto lens, focuses on a small part of
the scene. A large field of view, like a wide-angle lens, focuses on a
large part of the scene.</dd>
	
	<dd>
		  <dl>
		    <dt><strong>&lt;leftFov&gt; <a name="leftfov" id="leftfov"></a></strong> </dt>
	      <dd>Angle, in degrees, between the camera's viewing direction and the left side of the view volume.</dd>
	      <dt><strong>&lt;rightFov</strong>&gt;<a name="rightfov" id="rightfov"></a></dt>
	      <dd>Angle, in degrees, between the camera's viewing direction and the right side of the view volume. </dd>
		    <dt><strong>&lt;bottomFov&gt; <a name="bottomfov" id="bottomfov"></a></strong> </dt>
	      <dd>Angle, in degrees, between the camera's viewing direction and the bottom side of the view volume. </dd>
		    <dt><strong>&lt;topFov&gt; <a name="topfov" id="topfov"></a></strong> </dt>
	      <dd>Angle, in degrees, between the camera's viewing direction and the top side of the view volume. </dd>
			  <dt><strong>&lt;near&gt; <a name="near" id="near"></a></strong> </dt>
	      <dd>Measurement in meters along the viewing direction from the camera viewpoint to the PhotoOverlay shape.</dd>
		  </dl>
	</dd>
		
	<dd>The field of view for a PhotoOverlay is defined by four planes, each of which is specified by an angle relative to the <em><a href="http://code.google.com/intl/de/apis/kml/documentation/photos.html#viewVector">view vector</a></em>.
These four planes define the top, bottom, left, and right sides of the
field of view, which has the shape of a truncated pyramid, as shown
here:</dd>
		<dd><img src="kmlreference22_ext-Dateien/fieldOfView.gif" alt="" height="320" width="478"></dd>
		<dd>The following diagrams show the four field-of-view angles within this pyramid:
      <img src="kmlreference22_ext-Dateien/twoFovs.gif" alt="">
    </dd>
		
				
		<dt><strong>&lt;ImagePyramid&gt;</strong><a name="imagepyramid" id="imagepyramid"></a></dt>
	  <dd>For
very large images, you'll need to construct an image pyramid, which is
a hierarchical set of images, each of which is an increasingly lower
resolution version of the original image. Each image in the pyramid is
subdivided into tiles, so that only the portions in view need to be
loaded. Google Earth calculates the current viewpoint and loads the
tiles that are appropriate to the user's distance from the image. As
the viewpoint moves closer to the PhotoOverlay, Google Earth loads
higher resolution tiles. Since all the pixels in the original image
can't be viewed on the screen at once, this preprocessing allows Google
Earth to achieve maximum performance because it loads only the portions
of the image that are in view, and only the pixel details that can be
discerned by the user at the current viewpoint.</dd>
	
  <dd>When you
specify an image pyramid, you also modify the &lt;href&gt; in the
&lt;Icon&gt; element to include specifications for which tiles to load.
</dd>
  
	<dd>
	  <dl>
      <dt><strong>&lt;tileSize&gt;</strong><a name="tilesize" id="tilesize"></a></dt>
	    <dd>Size
of the tiles, in pixels. Tiles must be square, and &lt;tileSize&gt;
must be a power of 2. A tile size of 256 (the default) or 512 is
recommended. The original image is divided into tiles of this size, at
varying resolutions.</dd>
	    <dt><strong>&lt;maxWidth&gt;</strong><a name="maxwidth" id="maxwidth"></a></dt>
	    <dd>Width in pixels of the original image. </dd>
	    <dt><strong>&lt;maxHeight&gt;<a name="maxheight" id="maxheight"></a></strong></dt>
	    <dd>Height in pixels of the original image. </dd>
			<dt><strong>&lt;gridOrigin&gt;</strong><a name="gridorigin" id="gridorigin"></a></dt>
	    <dd>Specifies where to begin numbering the tiles in each layer of the pyramid. A value of <code>lowerLeft</code> specifies that row 1, column 1 of each layer is in the bottom left corner of the grid. </dd>
		</dl>
	</dd>
		
		<dt><strong><a href="#point">&lt;Point&gt;</a></strong> </dt>
		<dd>The
&lt;Point&gt; element acts as a &lt;Point&gt; inside a
&lt;Placemark&gt; element. It draws an icon to mark the position of the
PhotoOverlay. The icon drawn is specified by the &lt;styleUrl&gt; and
&lt;StyleSelector&gt; fields, just as it is for &lt;Placemark&gt;.</dd>
		<dt><strong>&lt;shape&gt; <a name="shape" id="shape"></a></strong> </dt>
	<dd>The PhotoOverlay is projected onto the &lt;shape&gt;. The &lt;shape&gt; can be one of the following:
		  <p><strong>rectangle (default)</strong> - for an ordinary photo</p>
		  <p><strong>cylinder</strong> - for panoramas, which can be either partial or full cylinders</p>
		  <p><strong>sphere</strong> - for spherical panoramas</p>
	</dd>
</dl>	

<h3>Example</h3>
     <pre><strong>&lt;PhotoOverlay&gt;</strong>
  &lt;!-- Feature elements --&gt;
  &lt;name&gt;A simple non-pyramidal photo&lt;/name&gt;
  &lt;description&gt;High above the ocean&lt;/description&gt;
  &lt;!-- Overlay elements --&gt;
  &lt;Icon&gt;
  &lt;!-- A simple normal jpeg image --&gt;
  &lt;href&gt;small-photo.jpg&lt;/href&gt;
  &lt;/Icon&gt;
  &lt;!-- PhotoOverlay elements --&gt;
  &lt;!-- default: &lt;rotation&gt; default is 0 --&gt;
  &lt;ViewVolume&gt;
    &lt;near&gt;1000&lt;/near&gt;
    &lt;leftFov&gt;-60&lt;/leftFov&gt;
    &lt;rightFov&gt;60&lt;/rightFov&gt;
    &lt;bottomFov&gt;-45&lt;/bottomFov&gt;
    &lt;topFov&gt;45&lt;/topFov&gt;
  &lt;/ViewVolume&gt;
  &lt;!-- if no ImagePyramid only level 0 is shown,
       fine for a non-pyramidal image --&gt;
  &lt;Point&gt;
    &lt;coordinates&gt;1,1&lt;/coordinates&gt;
  &lt;/Point&gt;
  &lt;!-- default: &lt;shape&gt; --&gt;
<strong>&lt;/PhotoOverlay&gt;</strong></pre>
     
     <h3>Extends</h3>
<ul>
	<li><a href="#overlay">&lt;Overlay&gt;</a></li>
</ul>
       
<h3>Contained By</h3> 
<ul> 
  <li><a href="#style">&lt;Folder&gt;</a>, <a href="#document">&lt;Document&gt;</a>, or <a href="#kml">&lt;kml&gt;</a></li>   
</ul>	    
 
<a name="placemark"></a>
<h2>&lt;Placemark&gt;</h2>
<h3>Syntax</h3>
	<pre><strong>&lt;Placemark id="ID"&gt;</strong>
  &lt;!-- inherited from <em>Feature</em> element --&gt;
  &lt;name&gt;<em>...</em>&lt;/name&gt;                      &lt;!-- string --&gt;
  &lt;visibility&gt;1&lt;/visibility&gt;            &lt;!-- boolean --&gt;
  &lt;open&gt;0&lt;/open&gt;                        &lt;!-- boolean --&gt;
  <span>&lt;atom:author&gt;...&lt;atom:author&gt;         &lt;!-- xmlns:atom --&gt;
  &lt;atom:link&gt;...&lt;/atom:link&gt;</span><span>            &lt;!-- xmlns:atom --&gt;</span>
  &lt;address&gt;<em>...</em>&lt;/address&gt;                &lt;!-- string --&gt;
  &lt;xal:AddressDetails&gt;...&lt;/xal:AddressDetails&gt;  &lt;!-- xmlns:xal --&gt;<br>  &lt;phoneNumber&gt;...&lt;/phoneNumber&gt;        &lt;!-- string --&gt;<br>  &lt;Snippet maxLines="2"&gt;<em>...</em>&lt;/Snippet&gt;   &lt;!-- string --&gt;
  &lt;description&gt;<em>...</em>&lt;/description&gt;        &lt;!-- string --&gt;
  <span><em>&lt;AbstractView&gt;...&lt;/AbstractView&gt;</em>      &lt;!-- Camera <em>or</em> LookAt --&gt;</span>
  &lt;<em>TimePrimitive</em>&gt;...&lt;/<em>TimePrimitive</em>&gt;
  &lt;styleUrl&gt;<em>...</em>&lt;/styleUrl&gt;              &lt;!-- anyURI --&gt;
  &lt;<em>StyleSelector&gt;...&lt;/StyleSelector&gt;</em>
  &lt;Region&gt;...&lt;/Region&gt;
  <span>&lt;Metadata&gt;...&lt;/Metadata&gt;              &lt;!-- deprecated in KML 2.2 --&gt;
  &lt;ExtendedData&gt;...&lt;/ExtendedData&gt;      &lt;!-- new in KML 2.2 --&gt;</span><br>
  &lt;!-- specific to Placemark element --&gt;
  <em>&lt;Geometry&gt;...&lt;/Geometry&gt;</em>
<strong>&lt;/Placemark&gt;</strong></pre>

<h3>Description</h3>
<p>A Placemark is a Feature with associated Geometry. In Google Earth,
a Placemark appears as a list item in the Places panel. A Placemark
with a Point has an icon associated with it that marks a point on the
Earth in the 3D viewer. (In the Google Earth 3D viewer, a Point
Placemark is the only object you can click or roll over. Other Geometry
objects do not have an icon in the 3D viewer. To give the user
something to click in the 3D viewer, you would need to create a
MultiGeometry object that contains both a Point and the other Geometry
object.)</p>

<h3>Elements Specific to Placemark</h3>
<ul>
  <li> 0 or one <a href="#geometry"><em>&lt;Geometry&gt;</em></a> elements</li>
</ul>

<h3>Example</h3>
<pre><strong>&lt;Placemark&gt;</strong>
  &lt;name&gt;Google Earth - New Placemark&lt;/name&gt;
  &lt;description&gt;Some Descriptive text.&lt;/description&gt;
  &lt;LookAt&gt;
    &lt;longitude&gt;-90.86879847669974&lt;/longitude&gt;
    &lt;latitude&gt;48.25330383601299&lt;/latitude&gt;
    &lt;range&gt;440.8&lt;/range&gt;
    &lt;tilt&gt;8.3&lt;/tilt&gt;
    &lt;heading&gt;2.7&lt;/heading&gt;
  &lt;/LookAt&gt;
  &lt;Point&gt;
    &lt;coordinates&gt;-90.86948943473118,48.25450093195546,0&lt;/coordinates&gt;
  &lt;/Point&gt;
<strong>&lt;/Placemark&gt;</strong></pre>

<h3>Extends</h3>
<ul>
	<li><a href="#feature">&lt;<em>Feature</em>&gt;</a></li>
</ul>

<h3>Contained By</h3>
<ul>
	<li><a href="#document">&lt;Document&gt;</a></li>
	<li><a href="#folder">&lt;Folder&gt;</a></li>
</ul>

<h3>See Also</h3>
<ul>
	<li><a href="#icon">&lt;Icon&gt;</a></li>
</ul>
	  
<a name="point"></a>
<h2>&lt;Point&gt;</h2>
<h3>Syntax </h3>
    <pre><strong>&lt;Point id="ID"&gt;</strong>
  &lt;!-- specific to Point --&gt;
  &lt;extrude&gt;0&lt;/extrude&gt;                        &lt;!-- boolean --&gt;
  &lt;altitudeMode&gt;clampToGround&lt;/altitudeMode&gt;  
	      &lt;!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute --&gt;
        &lt;!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor --&gt;
  &lt;coordinates&gt;<em>...</em>&lt;/coordinates&gt;<span class="style1"><em>              </em></span>&lt;!-- lon,lat[,alt] --&gt;
<strong>&lt;/Point&gt;</strong></pre>

    <h3>Description</h3>
<p>A geographic location defined by longitude, latitude, and (optional)
altitude. When a Point is contained by a Placemark, the point itself
determines the position of the Placemark's name and icon. When a Point
is extruded, it is connected to the ground with a line. This "tether"
uses the current LineStyle.</p>
    
<h3>Elements Specific to Point</h3>
<dl>
  <dt><strong>&lt;extrude&gt;<a name="extrude" id="extrude"></a></strong></dt>
  <dd>Boolean
value. Specifies whether to connect the point to the ground with a
line. To extrude a Point, the value for &lt;altitudeMode&gt; must be
either <strong>relativeToGround</strong>, <strong>relativeToSeaFloor</strong>, or <strong>absolute</strong>. The point is extruded toward the center of the Earth's sphere.</dd>
  <dt><strong>&lt;altitudeMode&gt;<a name="altitudemode" id="altitudemode"></a></strong></dt>
  <dd>Specifies how <em>altitude</em> components in the &lt;coordinates&gt; element are interpreted. Possible values are
     <ul>
       <li><strong>clampToGround </strong>- (default) Indicates to ignore an altitude specification (for example, in the &lt;coordinates&gt; tag). </li>
       <li><strong>relativeToGround</strong>
- Sets the altitude of the element relative to the actual ground
elevation of a particular location. For example, if the ground
elevation of a location is exactly at sea level and the altitude for a
point is set to 9 meters, then the elevation for the icon of a point
placemark elevation is 9 meters with this mode. However, if the same
coordinate is set over a location where the ground elevation is 10
meters above sea level, then the elevation of the coordinate is 19
meters. A typical use of this mode is for placing telephone poles or a
ski lift.</li>
       <li><strong>absolute </strong>- Sets the altitude
of the coordinate relative to sea level, regardless of the actual
elevation of the terrain beneath the element. For example, if you set
the altitude of a coordinate to 10 meters with an <strong>absolute</strong>
altitude mode, the icon of a point placemark will appear to be at
ground level if the terrain beneath is also 10 meters above sea level.
If the terrain is 3 meters above sea level, the placemark will appear
elevated above the terrain by 7 meters. A typical use of this mode is
for aircraft placement.</li>
     </ul>
  </dd>
  <dt>&lt;gx:altitudeMode&gt;
      </dt>
  <dd>A KML extension in the <a href="#kmlextensions">Google extension namespace</a>, allowing altitudes relative to the sea floor. Values are:
    <ul>
        <li><strong>relativeToSeaFloor</strong>
- Interprets the altitude as a value in meters above the sea floor. If
the point is above land rather than sea, the altitude will be
interpreted as being above the ground.</li>
      <li><strong>clampToSeaFloor</strong>
- The altitude specification is ignored, and the point will be
positioned on the sea floor. If the point is on land rather than at
sea, the point will be positioned on the ground.</li>
    </ul>
  </dd>
  <dt><strong>&lt;coordinates&gt;<a name="coordinates" id="coordinates"></a> </strong><em>(required)</em> </dt>
	 <dd>A
single tuple consisting of floating point values for longitude,
latitude, and altitude (in that order). Longitude and latitude values
are in degrees, where <ul>
	    <li><em>longitude</em> ≥ −180 and &lt;= 180 </li>
	    <li><em>latitude</em> ≥ −90 and ≤ 90</li>
	    <li><em>altitude</em> values (optional) are in meters above sea level </li>
    </ul>
  </dd>
	<dd> Do not include spaces between the three values that describe a coordinate. </dd>
</dl>

<h3>Example</h3>
<pre><strong>&lt;Point&gt;</strong>
  &lt;coordinates&gt;-90.86948943473118,48.25450093195546&lt;/coordinates&gt;
<strong>&lt;/Point&gt;</strong></pre>
 
<h3>Extends</h3>
<ul>
	  <li><a href="#geometry">&lt;<em>Geometry</em>&gt;</a></li>
</ul>
       
<h3>Contained By</h3> 
<ul> 
  <li><a href="#multigeometry">&lt;MultiGeometry&gt;</a> </li>
  <li><a href="#placemark">&lt;Placemark&gt;</a></li> 
</ul> 
	
<a name="polygon"></a>
<h2>&lt;Polygon&gt;</h2>
<h3>Syntax</h3>
<pre><strong>&lt;Polygon id="ID"&gt;</strong>
  &lt;!-- specific to Polygon --&gt;
  &lt;extrude&gt;0&lt;/extrude&gt;                       &lt;!-- boolean --&gt;
  &lt;tessellate&gt;0&lt;/tessellate&gt;                 &lt;!-- boolean --&gt;
  &lt;altitudeMode&gt;clampToGround&lt;/altitudeMode&gt; 
        &lt;!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute --&gt;
        &lt;!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor --&gt;
  &lt;outerBoundaryIs&gt;
    &lt;LinearRing&gt;
      &lt;coordinates&gt;...&lt;/coordinates&gt;         &lt;!-- lon,lat[,alt] --&gt;
    &lt;/LinearRing&gt;
  &lt;/outerBoundaryIs&gt;
  &lt;innerBoundaryIs&gt;
    &lt;LinearRing&gt;
      &lt;coordinates&gt;...&lt;/coordinates&gt;         &lt;!-- lon,lat[,alt] --&gt;
    &lt;/LinearRing&gt;
  &lt;/innerBoundaryIs&gt;
<strong>&lt;/Polygon&gt;</strong></pre>

<h3>Description </h3>
<p>A Polygon is defined by an outer boundary and 0 or more inner
boundaries. The boundaries, in turn, are defined by LinearRings. When a
Polygon is extruded, its boundaries are connected to the ground to form
additional polygons, which gives the appearance of a building or a box.
Extruded Polygons use <a href="#polystyle">&lt;PolyStyle&gt; </a>for their color, color mode, and fill. </p>
<p>The &lt;coordinates&gt; for polygons must be specified in
counterclockwise order. Polygons follow the "right-hand rule," which
states that if you place the fingers of your right hand in the
direction in which the coordinates are specified, your thumb points in
the general direction of the geometric normal for the polygon. (In 3D
graphics, the geometric normal is used for lighting and points away
from the front face of the polygon.) Since Google Earth fills only the
front face of polygons, you will achieve the desired effect only when
the coordinates are specified in the proper order. Otherwise, the
polygon will be gray.</p>
<p class="note"><span><strong>Note:</strong> In Google Earth, a Polygon with an &lt;altitudeMode&gt; of <em>clampToGround</em> follows the great circle; however, a LinearRing (by itself) with an &lt;altitudeMode&gt; of <em>clampToGround</em> follows lines of constant latitude.</span> </p>
<h3>Elements Specific to Polygon</h3>
<dl>
  <dt><strong>&lt;extrude&gt;<a name="extrude" id="extrude"></a></strong></dt>
  <dd>Boolean value. Specifies whether to connect the Polygon to the ground. To extrude a Polygon, the altitude mode must be either <strong>relativeToGround</strong>, <strong>relativeToSeaFloor</strong>, or <strong>absolute</strong>.
Only the vertices are extruded, not the geometry itself (for example, a
rectangle turns into a box with five faces. The vertices of the Polygon
are extruded toward the center of the Earth's sphere. </dd>
  <dt><strong>&lt;tessellate&gt;<a name="tessellate" id="tessellate"></a></strong></dt>
  <dd>Boolean
value. Specifies whether to allow the Polygon to follow the terrain. To
enable tessellation, the Polygon must have an altitude mode of <strong>clampToGround</strong> or <strong>clampToSeaFloor</strong>.
Very large Polygons should enable tessellation so that they follow the
curvature of the earth (otherwise, they may go underground and be
hidden).</dd>
  <dt><strong>&lt;altitudeMode&gt;<a name="altitudemode" id="altitudemode"></a></strong></dt>
  <dd>Specifies how <em>altitude</em> components in the &lt;coordinates&gt; element are interpreted. Possible values are
    <ul>
      <li><strong>clampToGround </strong>- (default) Indicates to ignore an altitude specification (for example, in the &lt;coordinates&gt; tag).</li>
      <li><strong>relativeToGround</strong>
- Sets the altitude of the element relative to the actual ground
elevation of a particular location. For example, if the ground
elevation of a location is exactly at sea level and the altitude for a
point is set to 9 meters, then the elevation for the icon of a point
placemark elevation is 9 meters with this mode. However, if the same
coordinate is set over a location where the ground elevation is 10
meters above sea level, then the elevation of the coordinate is 19
meters. A typical use of this mode is for placing telephone poles or a
ski lift.</li>
      <li><strong>absolute </strong>- Sets the altitude
of the coordinate relative to sea level, regardless of the actual
elevation of the terrain beneath the element. For example, if you set
the altitude of a coordinate to 10 meters with an <strong>absolute</strong>
altitude mode, the icon of a point placemark will appear to be at
ground level if the terrain beneath is also 10 meters above sea level.
If the terrain is 3 meters above sea level, the placemark will appear
elevated above the terrain by 7 meters. A typical use of this mode is
for aircraft placement.</li>
    </ul>
  </dd>
  <dt>&lt;gx:altitudeMode&gt;
      </dt>
  <dd>A KML extension in the <a href="#kmlextensions">Google extension namespace</a>, allowing altitudes relative to the sea floor. Values are:
    <ul>
        <li><strong>relativeToSeaFloor</strong>
- Interprets the &lt;altitude&gt; as a value in meters above the sea
floor. If the point is above land rather than sea, the altitude will be
interpreted as being above the ground.</li>
      <li><strong>clampToSeaFloor</strong>
- The altitude specification is ignored, and the point will be
positioned on the sea floor. If the point is on land rather than at
sea, the point will be positioned on the ground.</li>
    </ul>
  </dd>
  <dt><strong>&lt;outerBoundaryIs&gt; </strong><em>(required)</em> <a name="outerboundaryis" id="outerboundaryis"></a></dt>
	<dd>Contains a <a href="#linearring">&lt;LinearRing&gt;</a> element. </dd>
	<dt><strong>&lt;innerBoundaryIs&gt;</strong></dt>
	<dd>Contains a <a href="#linearring">&lt;LinearRing&gt;</a> element. <a name="innerboundaryis" id="innerboundaryis"></a> A Polygon can contain multiple &lt;innerBoundaryIs&gt; elements, which create multiple cut-outs inside the Polygon. </dd>
</dl>

<h3>Example</h3>
     <pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>&lt;kml xmlns="http://www.opengis.net/kml/2.2"&gt;<br>&lt;Document&gt;<br>  &lt;name&gt;Polygon.kml&lt;/name&gt;<br>  &lt;open&gt;0&lt;/open&gt;<br>  &lt;Placemark&gt;<br>    &lt;name&gt;hollow box&lt;/name&gt;<br>    &lt;Polygon&gt;<br>      &lt;extrude&gt;1&lt;/extrude&gt;<br>      &lt;altitudeMode&gt;relativeToGround&lt;/altitudeMode&gt;<br>      &lt;outerBoundaryIs&gt;<br>        &lt;LinearRing&gt;<br>          &lt;coordinates&gt;<br>            -122.366278,37.818844,30<br>            -122.365248,37.819267,30<br>            -122.365640,37.819861,30<br>            -122.366669,37.819429,30<br>            -122.366278,37.818844,30<br>          &lt;/coordinates&gt;<br>        &lt;/LinearRing&gt;<br>      &lt;/outerBoundaryIs&gt;<br>      &lt;innerBoundaryIs&gt;<br>        &lt;LinearRing&gt;<br>          &lt;coordinates&gt;<br>            -122.366212,37.818977,30<br>            -122.365424,37.819294,30<br>            -122.365704,37.819731,30<br>            -122.366488,37.819402,30<br>            -122.366212,37.818977,30<br>          &lt;/coordinates&gt;<br>        &lt;/LinearRing&gt;<br>      &lt;/innerBoundaryIs&gt;<br>    &lt;/Polygon&gt;<br>  &lt;/Placemark&gt;<br>&lt;/Document&gt;<br>&lt;/kml&gt;</pre> 
		 
<h3>Extends</h3>
<ul>
	  <li><a href="#geometry">&lt;<em>Geometry</em>&gt;</a></li>
</ul>
       
<h3>Contained By</h3> 
<ul> 
  <li><a href="#multigeometry">&lt;MultiGeometry&gt;</a></li>
  <li><a href="#placemark">&lt;Placemark&gt;</a></li> 
</ul> 
	
<a name="polystyle"></a>
<h2>&lt;PolyStyle&gt;</h2>
<h3>Syntax</h3>
    <pre><strong>&lt;PolyStyle id="ID"&gt;</strong>
  &lt;!-- inherited from <em>ColorStyle</em> --&gt;
  &lt;color&gt;ffffffff&lt;/color&gt;            &lt;!-- kml:color --&gt;
  &lt;colorMode&gt;normal&lt;/colorMode&gt;      &lt;!-- kml:colorModeEnum: normal <em>or</em> random --&gt;

  &lt;!-- specific to PolyStyle --&gt;
  &lt;fill&gt;1&lt;/fill&gt;                     &lt;!-- boolean --&gt;
  &lt;outline&gt;1&lt;/outline&gt;               &lt;!-- boolean --&gt;
<strong>&lt;/PolyStyle&gt;</strong></pre>
    <p><strong>Description </strong></p>
    <p>Specifies
the drawing style for all polygons, including polygon extrusions (which
look like the walls of buildings) and line extrusions (which look like
solid fences). </p>
    
<h3>Elements Specific to PolyStyle</h3>
<dl>
  <dt><strong>&lt;fill&gt; <a name="fill" id="fill"></a></strong> </dt>
	<dd>Boolean value. Specifies whether to fill the polygon. </dd>
	<dt><strong>&lt;outline</strong>&gt;<a name="outline" id="outline"></a></dt>
	<dd>Boolean value. Specifies whether to outline the polygon. Polygon outlines use the current LineStyle. </dd>
</dl>
	
<h3>Example</h3>
     <pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>&lt;kml xmlns="http://www.opengis.net/kml/2.2"&gt;<br>&lt;Document&gt;<br>  &lt;name&gt;PolygonStyle.kml&lt;/name&gt;<br>  &lt;open&gt;1&lt;/open&gt;<br>  &lt;Style id="examplePolyStyle"&gt;<br>    <strong>&lt;PolyStyle&gt;</strong><br>      &lt;color&gt;ff0000cc&lt;/color&gt;<br>      &lt;colorMode&gt;random&lt;/colorMode&gt;<br>    <strong>&lt;/PolyStyle&gt;</strong><br>  &lt;/Style&gt;<br>  &lt;Placemark&gt;<br>    &lt;name&gt;hollow box&lt;/name&gt;<br>    &lt;styleUrl&gt;#examplePolyStyle&lt;/styleUrl&gt;<br>    &lt;Polygon&gt;<br>      &lt;extrude&gt;1&lt;/extrude&gt;<br>      &lt;altitudeMode&gt;relativeToGround&lt;/altitudeMode&gt;<br>      &lt;outerBoundaryIs&gt;<br>        &lt;LinearRing&gt;<br>          &lt;coordinates&gt;<br>            -122.3662784465226,37.81884427772081,30 
            -122.3652480684771,37.81926777010555,30 
            -122.365640222455,37.81986126286519,30 
            -122.36666937925,37.81942987753481,30 
            -122.3662784465226,37.81884427772081,30 
          &lt;/coordinates&gt;<br>        &lt;/LinearRing&gt;<br>      &lt;/outerBoundaryIs&gt;<br>      &lt;innerBoundaryIs&gt;<br>        &lt;LinearRing&gt;<br>          &lt;coordinates&gt;<br>            -122.366212593918,37.81897719083808,30 
            -122.3654241733188,37.81929450992014,30 
            -122.3657048517827,37.81973175302663,30 
            -122.3664882465854,37.81940249291773,30 
            -122.366212593918,37.81897719083808,30 
          &lt;/coordinates&gt;<br>        &lt;/LinearRing&gt;<br>      &lt;/innerBoundaryIs&gt;<br>    &lt;/Polygon&gt;<br>  &lt;/Placemark&gt;<br>&lt;/Document&gt;<br>&lt;/kml&gt;</pre> 
					
<h3>Extends</h3>
<ul>
	<li><a href="#colorstyle">&lt;<em>ColorStyle</em>&gt;</a></li>
</ul>
       
<h3>Contained By</h3> 
<ul> 
  <li><a href="#style">&lt;Style&gt;</a></li> 
</ul> 
	
<a name="region"></a>
<h2>&lt;Region&gt;</h2>
<h3>Syntax</h3>
<pre><strong>&lt;Region id="ID"&gt; </strong>
  &lt;LatLonAltBox&gt; 
    &lt;north&gt;&lt;/north&gt;                            &lt;!-- required; kml:angle90 --&gt;
    &lt;south&gt;&lt;/south&gt;                            &lt;!-- required; kml:angle90 --&gt; 
    &lt;east&gt;&lt;/east&gt;                              &lt;!-- required; kml:angle180 --&gt;
    &lt;west&gt;&lt;/west&gt;                              &lt;!-- required; kml:angle180 --&gt;
    &lt;minAltitude&gt;0&lt;/minAltitude&gt;               &lt;!-- float --&gt;
    &lt;maxAltitude&gt;0&lt;/maxAltitude&gt;               &lt;!-- float --&gt;
    &lt;altitudeMode&gt;clampToGround&lt;/altitudeMode&gt; 
        &lt;!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute --&gt;
        &lt;!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor --&gt; 
  &lt;/LatLonAltBox&gt; 
  &lt;Lod&gt;
    &lt;minLodPixels&gt;0&lt;/minLodPixels&gt;             &lt;!-- float --&gt;
    &lt;maxLodPixels&gt;-1&lt;/maxLodPixels&gt;            &lt;!-- float --&gt;
    &lt;minFadeExtent&gt;0&lt;/minFadeExtent&gt;           &lt;!-- float --&gt; 
    &lt;maxFadeExtent&gt;0&lt;/maxFadeExtent&gt;           &lt;!-- float --&gt;
  &lt;/Lod&gt;
<strong>&lt;/Region&gt; </strong></pre>
	
<h3>Description</h3>
<p>A region contains a <em>bounding box</em> (<a href="#latlonaltbox">&lt;LatLonAltBox&gt;</a>) that describes an area of interest defined by geographic coordinates and altitudes. In addition, a Region contains an <em>LOD (level of detail) extent </em> (<a href="#lod">&lt;Lod&gt;</a>)
that defines a validity range of the associated Region in terms of
projected screen size. A Region is said to be "active" when the
bounding box is within the user's view and the LOD requirements are
met. Objects associated with a Region are drawn only when the Region is
active. When the &lt;viewRefreshMode&gt; is <strong>onRegion</strong>, the Link or Icon is loaded only when the Region is active. See the "Topics in KML" page on <a href="http://code.google.com/intl/de/apis/kml/documentation/regions.html">Regions</a>
for more details. In a Container or NetworkLink hierarchy, this
calculation uses the Region that is the closest ancestor in the
hierarchy.</p>

<h3>Elements Specific to Region</h3>
<dl>
	<dt><strong>&lt;LatLonAltBox&gt;<a name="latlonaltbox" id="latlonaltbox"></a></strong><em>(required)</em> </dt>
	<dd>A
bounding box that describes an area of interest defined by geographic
coordinates and altitudes. Default values and required fields are as
follows: </dd><dd>
	  <dl>
	    <dt>&lt;altitudeMode&gt; or &lt;gx:altitudeMode&gt;</dt>
			<dd>Possible values for &lt;altitudeMode&gt; are <strong>clampToGround</strong>, <strong>relativeToGround</strong>, and <strong>absolute</strong>. Possible values for &lt;gx:altitudeMode&gt; are <strong>clampToSeaFloor</strong> and <strong>relativeToSeaFloor</strong>. Also see <a href="#latlonbox">&lt;LatLonBox&gt;</a>. </dd>
	    <dt>&lt;minAltitude&gt;</dt> 
			<dd>Specified in meters (and is affected by the altitude mode specification). <a name="minaltitude" id="minaltitude"></a></dd>
	    <dt>&lt;maxAltitude&gt;</dt>
			<dd>Specified in meters (and is affected by the altitude mode specification). <a name="maxaltitude" id="maxaltitude"></a></dd>
	    <dt>&lt;north&gt;<em> (required)</em> </dt>
			<dd>Specifies the latitude of the north edge of the bounding box, in decimal degrees from 0 to ±90. <a name="north" id="north"></a></dd>
	    <dt>&lt;south&gt;<em> (required)</em> </dt>
			<dd>Specifies the latitude of the south edge of the bounding box, in decimal degrees from 0 to ±90. <a name="south" id="south"></a></dd>
	    <dt>&lt;east&gt;<em> (required)</em></dt><dt>
			</dt><dd>Specifies the longitude of the east edge of the bounding box, in decimal degrees from 0 to ±180. <a name="east" id="east"></a></dd>
	    <dt>&lt;west&gt;<em> (required)</em> </dt> 
			<dd>Specifies the longitude of the west edge of the bounding box, in decimal degrees from 0 to ±180. <a name="west" id="west"></a></dd>
	  
	    <!-- <li><strong>&lt;rotation&gt;<a name="rotation" id="rotation"></a></strong> <em>(optional)</em> specifies a rotation of the bounding box about its center, in degrees. Values can be &plusmn;180. The default is 0 (north). Rotations are specified in a clockwise direction. In Google Earth, this rotation is currently ignored. </li> -->
	  </dl>
	</dd>
		  <pre><strong>&lt;LatLonAltBox&gt;</strong><br>  &lt;north&gt;43.374&lt;/north&gt;<br>  &lt;south&gt;42.983&lt;/south&gt;<br>  &lt;east&gt;-0.335&lt;/east&gt;<br>  &lt;west&gt;-1.423&lt;/west&gt;<br>  &lt;minAltitude&gt;0&lt;/minAltitude&gt;<br>  &lt;maxAltitude&gt;0&lt;/maxAltitude&gt;<br><strong>&lt;/LatLonAltBox&gt;</strong></pre>
	  <dt><strong>&lt;Lod&gt;<a name="lod" id="lod"></a> </strong> </dt>
	  <dd><em>Lod</em> is an abbreviation for <em>Level of Detail</em>.
&lt;Lod&gt; describes the size of the projected region on the screen
that is required in order for the region to be considered "active."
Also specifies the size of the pixel ramp used for fading in (from
transparent to opaque) and fading out (from opaque to transparent). See
diagram below for a visual representation of these parameters. <pre><strong>&lt;Lod&gt;</strong><br>  &lt;minLodPixels&gt;256&lt;/minLodPixels&gt;<br>  &lt;maxLodPixels&gt;-1&lt;/maxLodPixels&gt;<br>  &lt;minFadeExtent&gt;0&lt;/minFadeExtent&gt;<br>  &lt;maxFadeExtent&gt;0&lt;/maxFadeExtent&gt;<br><strong>&lt;/Lod&gt;</strong></pre>
	</dd><dd>
	    <dl>
      <dt>&lt;minLodPixels<a name="minlodpixels" id="minlodpixels"></a>&gt; <strong><em>(required) </em></strong></dt> 
			<dd>Measurement
in screen pixels that represents the minimum limit of the visibility
range for a given Region. Google Earth calculates the size of the
Region when projected onto screen space. Then it computes the square
root of the Region's area (if, for example, the Region is square and
the viewpoint is directly above the Region, and the Region is not
tilted, this measurement is equal to the width of the projected
Region). If this measurement falls within the limits defined by
&lt;minLodPixels&gt; and &lt;maxLodPixels&gt; (and if the
&lt;LatLonAltBox&gt; is in view), the Region is active. If this limit
is not reached, the associated geometry is considered to be too far
from the user's viewpoint to be drawn. </dd>
      <dt>&lt;maxLodPixels<a name="maxlodpixels" id="maxlodpixels"></a>&gt;</dt> 
			<dd>Measurement
in screen pixels that represents the maximum limit of the visibility
range for a given Region. A value of −1, the default, indicates "active
to infinite size." </dd>
      <dt>&lt;minFadeExtent<a name="minfadeextent" id="minfadeextent"></a>&gt;</dt> 
			<dd>Distance
over which the geometry fades, from fully opaque to fully transparent.
This ramp value, expressed in screen pixels, is applied at the minimum
end of the LOD (visibility) limits. </dd>
      <dt>&lt;maxFadeExtent<a name="maxfadeextent" id="maxfadeextent"></a>&gt;</dt>
			<dd>Distance
over which the geometry fades, from fully transparent to fully opaque.
This ramp value, expressed in screen pixels, is applied at the maximum
end of the LOD (visibility) limits. </dd>
</dl>
  </dd>
    <dd><img src="kmlreference22_ext-Dateien/visibilityRange.gif" alt="" height="268" width="625"></dd>
	  <dd>In the following diagram, if <em>P</em>=the calculated projected pixel size, the circled numbers indicate the following:
	<pre>if (<em>P</em> &lt; <em>minLodPixels</em>) 
  <em>opacity</em>=0                                 //#<strong>1</strong> in diagram
else if(<em>P</em> &lt; <em>minLodPixels</em> + <em>minFadeExtent</em>)
  <em>opacity</em>=(<em>P</em> - <em>minLodPixels</em>)/<em>minFadeExtent</em>  //#<strong>2</strong> in diagram
else if (<em>P</em> &lt; <em>maxLodPixels</em> - <em>maxFadeExtent</em>)
  <em>opacity</em>=1                                 //<strong>#3</strong> in diagram
else if (<em>P</em> &lt; <em>maxLodPixels</em>)
  <em>opacity</em>=(<em>maxLodPixels-P</em>)/<em>maxFadeExtent</em>    //#<strong>4</strong> in diagram
else
  <em>opacity</em>=0      <em>                           //</em>#<strong>5 </strong>in diagram</pre></dd>
	<dd><img src="kmlreference22_ext-Dateien/lodDetails.gif" height="139" width="373"></dd>
</dl>
  
<h3>Example of &lt;Region&gt;</h3>
    <pre><strong>&lt;Region&gt;</strong> 
  &lt;LatLonAltBox&gt; 
    &lt;north&gt;50.625&lt;/north&gt; 
    &lt;south&gt;45&lt;/south&gt; 
    &lt;east&gt;28.125&lt;/east&gt; 
    &lt;west&gt;22.5&lt;/west&gt; 
    &lt;minAltitude&gt;10&lt;/minAltitude&gt; 
    &lt;maxAltitude&gt;50&lt;/maxAltitude&gt; 
  &lt;/LatLonAltBox&gt; 
  &lt;Lod&gt; 
    &lt;minLodPixels&gt;128&lt;/minLodPixels&gt; 
    &lt;maxLodPixels&gt;1024&lt;/maxLodPixels&gt; 
    &lt;minFadeExtent&gt;128&lt;/minFadeExtent&gt; 
    &lt;maxFadeExtent&gt;128&lt;/maxFadeExtent&gt; 
  &lt;/Lod&gt; 
<strong>&lt;/Region&gt;</strong> </pre>

<h3>Extends</h3>
<ul>
  <li><a href="#object">&lt;<em>Object</em>&gt;</a></li>
</ul>

<h3>Contained By</h3>
<ul>
  <li>any element derived from <a href="#feature">&lt;<em>Feature</em>&gt;</a></li>
</ul>

<a name="schema"></a>

<h2>&lt;Schema&gt;<span></span></h2><h3>Syntax</h3>
    <pre>&lt;Schema name="string" id="ID"&gt;
  &lt;SimpleField type="string" name="string"&gt;
    &lt;displayName&gt;...&lt;/displayName&gt;            &lt;!-- string --&gt;
  &lt;/SimpleField&gt;
&lt;/Schema&gt;</pre>

    <h3>Description</h3>
<p>Specifies a custom KML schema that is used to add custom data to KML
Features. The "id" attribute is required and must be unique within the
KML file. &lt;Schema&gt; is always a child of &lt;Document&gt;. </p>
    
<h3>Elements Specific to Schema</h3>
<p>
  A Schema element contains one or more SimpleField elements. In the SimpleField, the Schema declares the <em>type</em> and <em>name</em> of the custom field. It optionally specifies a <em>displayName</em> (the user-friendly form, with spaces and proper punctuation used for display in Google Earth) for this custom field. 
</p>
    
<dt>&lt;SimpleField type="<em>string</em>" name="<em>string</em>"&gt;<a name="simplefield" id="simplefield"></a></dt>
<dd>The declaration of the custom field, which must specify both the <em>type</em> and the <em>name</em> of this field. If either the <em>type </em>or the <em>name</em> is omitted, the field is ignored. The <em>type</em> can be one of the following:
  <ul>
<li>string</li>
<li>int</li>
<li>uint</li>
<li>short</li>
<li>ushort</li>
<li>float</li>
<li>double</li>
<li>bool</li>
</ul> </dd>

<dd>
<dl>
<dt>&lt;displayName&gt;<a name="displayname" id="displayname"></a></dt>
<dd>The name, if any, to be used when the field name is displayed to
the Google Earth user. Use the [CDATA] element to escape standard HTML
markup. </dd>
</dl>
</dd>

<h3>Example</h3>
<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>&lt;kml xmlns="http://www.opengis.net/kml/2.2"&gt;<br>&lt;Document&gt;<br>  &lt;Schema name="TrailHeadType" id="TrailHeadTypeId"&gt;          
    &lt;SimpleField type="string" name="TrailHeadName"&gt;       
      &lt;displayName&gt;&lt;![CDATA[&lt;b&gt;Trail Head Name&lt;/b&gt;]]&gt;&lt;/displayName&gt;     
    &lt;/SimpleField&gt;     
    &lt;SimpleField type="double" name="TrailLength"&gt;       
      &lt;displayName&gt;&lt;![CDATA[&lt;i&gt;The length in miles&lt;/i&gt;]]&gt;&lt;/displayName&gt;     
    &lt;/SimpleField&gt;
    &lt;SimpleField type="int" name="ElevationGain"&gt;       
      &lt;displayName&gt;&lt;![CDATA[&lt;i&gt;change in altitude&lt;/i&gt;]]&gt;&lt;/displayName&gt;     
    &lt;/SimpleField&gt;   
  &lt;/Schema&gt; <br>&lt;/Document&gt;<br>&lt;/kml&gt;</pre>
 
<h3>Extends</h3>
<p>This is a root element.</p>

<h3>Contained By</h3> 
<ul> 
  <li><a href="#document">&lt;Document&gt;</a></li>     
</ul>
 
<h3>See Also</h3> 
<ul> 
  <li><a href="#schemadata">&lt;SchemaData&gt;</a></li>      
</ul>
	  


<a name="screenoverlay"></a>

<h2>&lt;ScreenOverlay&gt;</h2><h3>Syntax</h3>
    <pre><strong>&lt;ScreenOverlay id="ID"&gt;</strong>
  &lt;!-- inherited from <em>Feature</em> element --&gt;
  &lt;name&gt;<em>...</em>&lt;/name&gt;                      &lt;!-- string --&gt;
  &lt;visibility&gt;1&lt;/visibility&gt;            &lt;!-- boolean --&gt;
  &lt;open&gt;0&lt;/open&gt;                        &lt;!-- boolean --&gt;
  <span>&lt;atom:author&gt;...&lt;atom:author&gt;         &lt;!-- xmlns:atom --&gt;
  &lt;atom:link&gt;...&lt;/atom:link&gt;</span><span>            &lt;!-- xmlns:atom --&gt;</span>
  &lt;address&gt;<em>...</em>&lt;/address&gt;                &lt;!-- string --&gt;
  &lt;xal:AddressDetails&gt;...&lt;/xal:AddressDetails&gt;  &lt;!-- xmlns:xal --&gt;<br>  &lt;phoneNumber&gt;...&lt;/phoneNumber&gt;        &lt;!-- string --&gt;<br>  &lt;Snippet maxLines="2"&gt;<em>...</em>&lt;/Snippet&gt;   &lt;!-- string --&gt;
  &lt;description&gt;<em>...</em>&lt;/description&gt;        &lt;!-- string --&gt;
  <span><em>&lt;AbstractView&gt;...&lt;/AbstractView&gt;</em>      &lt;!-- Camera <em>or</em> LookAt --&gt;</span>
  &lt;<em>TimePrimitive</em>&gt;...&lt;/<em>TimePrimitive</em>&gt;
  &lt;styleUrl&gt;<em>...</em>&lt;/styleUrl&gt;              &lt;!-- anyURI --&gt;
  &lt;<em>StyleSelector&gt;...&lt;/StyleSelector&gt;</em>
  &lt;Region&gt;...&lt;/Region&gt;
  <span>&lt;Metadata&gt;...&lt;/Metadata&gt;              &lt;!-- deprecated in KML 2.2 --&gt;
  &lt;ExtendedData&gt;...&lt;/ExtendedData&gt;      &lt;!-- new in KML 2.2 --&gt;

  </span>&lt;!-- inherited from <em>Overlay</em> element --&gt;
  &lt;color&gt;ffffffff&lt;/color&gt;                  &lt;!-- kml:color --&gt;
  &lt;drawOrder&gt;0&lt;/drawOrder&gt;                 &lt;!-- int --&gt;
  &lt;Icon&gt;...&lt;/Icon&gt;

  &lt;!-- specific to ScreenOverlay --&gt;
  &lt;overlayXY x="double" y="double" xunits="fraction" yunits="fraction"/&gt;    
    &lt;!-- vec2 --&gt;
    &lt;!-- xunits and yunits can be one of: fraction, pixels, <em>or</em> insetPixels --&gt;
  &lt;screenXY x="double" y="double" xunits="fraction" yunits="fraction"<em>/</em>&gt;      
    &lt;!-- vec2 --&gt;
  &lt;rotationXY x="double" y="double" xunits="fraction" yunits"fraction"<em>/</em>&gt;  
    &lt;!-- vec2 --&gt;
  &lt;size x="double" y="double" xunits="fraction" yunits="fraction"<em>/</em>&gt;              
    &lt;!-- vec2 --&gt; 
  &lt;rotation&gt;0&lt;/rotation&gt;                   &lt;!-- float --&gt;
 <strong>&lt;/ScreenOverlay&gt;</strong></pre>
 
    <h3>Description</h3>
<p>This element draws an image overlay fixed to the screen. Sample uses
for ScreenOverlays are compasses, logos, and heads-up displays.
ScreenOverlay sizing is determined by the &lt;size&gt; element.
Positioning of the overlay is handled by mapping a point in the image
specified by &lt;overlayXY&gt; to a point on the screen specified by
&lt;screenXY&gt;. Then the image is rotated by &lt;rotation&gt; degrees
about a point relative to the screen specified by &lt;rotationXY&gt;.<!-- See <a href="kml_basics.html">KML Basics </a> for details.-->  </p>
<p>The &lt;href&gt; child of &lt;Icon&gt; specifies the image to be
used as the overlay. This file can be either on a local file system or
on a web server. If this element is omitted or contains no
&lt;href&gt;, a rectangle is drawn using the color and size defined by
the screen overlay. </p>
<h3>Elements Specific to ScreenOverlay</h3>
<dl>
	<dt><strong>&lt;overlayXY&gt;<a name="overlayxy" id="overlayxy"></a> </strong></dt>
	<dd>Specifies a point on (or outside of) the overlay image that is mapped to the screen coordinate (<em>&lt;screenXY&gt;</em>). It requires <em>x</em> and <em>y</em> values, and the units for those values.</dd>
	<dd>The <em>x</em> and <em>y</em> values can be specified in three different ways: as <em>pixels</em> (<strong>"pixels"</strong>), as <em>fractions</em> of the image (<strong>"fraction"</strong>), or as <em>inset pixels </em>(<strong>"insetPixels"</strong>), which is an offset in pixels from the upper right corner of the image. The <em>x</em> and <em>y</em> positions can be specified in different ways—for example, <em>x</em> can be in pixels and <em>y</em> can be a fraction. The origin of the coordinate system is in the lower left corner of the image. 
	  <ul>
      <li><strong>x </strong>- Either the number of pixels, a fractional component of the image, or a pixel inset indicating the <em>x</em> component of a point on the overlay image.</li>
      <li><strong>y </strong>- Either the number of pixels, a fractional component of the image, or a pixel inset indicating the <em>y</em> component of a point on the overlay image.</li>
      <li><strong>xunits </strong>- Units in which the <em>x</em> value is specified. A value of <strong>"fraction"</strong> indicates the <em>x</em> value is a fraction of the image. A value of <strong>"pixels"</strong> indicates the <em>x</em> value in pixels. A value of <strong>"insetPixels"</strong> indicates the indent from the right edge of the image.</li>
      <li><strong>yunits</strong> - Units in which the <em>y</em> value is specified. A value of <strong>"fraction"</strong> indicates the <em>y</em> value is a fraction of the image. A value of <strong>"pixels"</strong> indicates the <em>y</em> value in pixels. A value of <strong>"insetPixels"</strong> indicates the indent from the top edge of the image.</li>
    </ul>
	</dd>
	<dt><strong>&lt;screenXY&gt;<a name="screenxy" id="screenxy"></a></strong></dt>
	<dd>Specifies a point relative to the screen origin that the overlay image is mapped to. The <em>x</em> and <em>y</em> values can be specified in three different ways:  as <em>pixels</em> (<strong>"pixels"</strong>), as <em>fractions</em> of the screen (<strong>"fraction"</strong>)<em>,</em> or as <em>inset pixels  </em>(<strong>"insetPixels"</strong>), which is an offset in pixels from the upper right corner of the screen.
	  The <em>x</em> and <em>y</em> positions can be specified in different ways—for example, <em>x</em> can be in pixels and <em>y</em> can be a fraction.
The	origin of the coordinate system is in the lower left corner of the screen.
	  <ul>
	    <li><strong>x </strong>- Either the number of pixels, a fractional component of the screen, or a pixel inset indicating the <em>x</em> component of a point on the screen.</li>
	    <li><strong>y </strong>- Either the number of pixels, a fractional component of the screen, or a pixel inset indicating the <em>y</em> component of a point on the screen.</li>
	    <li><strong>xunits </strong>- Units in which the <em>x</em> value is specified. A value of <strong>"fraction"</strong> indicates the <em>x</em> value is a fraction of the screen. A value of <strong>"pixels"</strong> indicates the <em>x</em> value in pixels. A value of <strong>"insetPixels"</strong> indicates the indent from the right edge of the screen.</li>
	    <li><strong>yunits</strong> - Units in which the <em>y</em> value is specified. A value of <em>fraction</em> indicates the <em>y</em> value is a fraction of the screen. A value of <strong>"pixels"</strong> indicates the <em>y</em> value in pixels. A value of <strong>"insetPixels"</strong> indicates the indent from the top edge of the screen.</li>
	  </ul>
  </dd>
	<dd>For example, &lt;<em>screenXY </em>x=".5" y=".5" xunits="fraction" yunits="fraction"/&gt; indicates a point in the middle of the screen. </dd>
	<dd>Here are some examples:</dd>
	<dd>
	  <p>Center the image:</p>
	  <pre><strong>&lt;ScreenOverlay&gt;</strong>
  &lt;overlayXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/&gt;
  &lt;screenXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/&gt;
<strong>&lt;/ScreenOverlay&gt;</strong></pre>
      <p>Place the image on the top left:</p>
      <pre><strong>&lt;ScreenOverlay&gt;</strong>
  &lt;overlayXY x="0" y="1" xunits="fraction" yunits="fraction"/&gt;
  &lt;screenXY x="0" y="1" xunits="fraction" yunits="fraction"/&gt;
<strong>&lt;/ScreenOverlay&gt;</strong> </pre>
      <p>Place the image at the right of the screen:</p>
      <pre><strong>&lt;ScreenOverlay&gt;</strong>
  &lt;overlayXY x="1" y="1" xunits="fraction" yunits="fraction"/&gt;
  &lt;screenXY x="1" y="1" xunits="fraction" yunits="fraction"/&gt;
<strong>&lt;/ScreenOverlay&gt;</strong>  </pre>
 </dd>
 <dt><strong>&lt;rotationXY&gt;<a name="rotationxy" id="rotationxy"></a></strong></dt>
	<dd>Point relative to the screen about which the screen overlay is rotated.</dd>
  <dt><strong>&lt;size&gt;<a name="size" id="size"></a></strong></dt>
  <dd>Specifies the size of the image for the screen overlay, as follows:
    <ul>
	    <li>A value of −1 indicates to use the native dimension</li>
      <li>A value of 0 indicates to maintain the aspect ratio</li>
      <li>A value of <em>n</em> sets the value of the dimension</li>
	  </ul>
	</dd>
	<dd>For example: </dd>
	<dd>
    <p>To force the image to retain its original <em>x</em> and <em>y</em> dimensions, set the values to −1:</p>
        <pre>&lt;size x="-1" y="-1" xunits="fraction" yunits="fraction"/&gt; </pre>
        <p>To force the image to retain its horizontal dimension, but to take up 20 percent of the vertical screen space:</p>
        <pre>&lt;size x="-1" y="0.2" xunits="fraction" yunits="fraction"/&gt; </pre>
        <p>To force the image to resize to 100px by 500px:</p>
        <pre>&lt;size x="100" y="500" xunits="pixels" yunits="pixels"/&gt; </pre>
  </dd>
	 <dt><strong>&lt;rotation&gt;<a name="rotation" id="rotation"></a></strong></dt>
	 <dd>Indicates
the angle of rotation of the parent object. A value of 0 means no
rotation. The value is an angle in degrees counterclockwise starting
from north. Use ±180 to indicate the rotation of the parent object from
0. The center of the &lt;rotation&gt;, if not (.5,.5), is specified in
&lt;rotationXY&gt;.</dd>
	 <dt><img src="kmlreference22_ext-Dateien/screenrotation.gif" height="372" width="557"></dt>
</dl>

<h3>Example</h3>
<p>The following example places an image at the exact center of the
screen, using the original width, height, and aspect ratio of the image.</p>
<pre><strong>&lt;ScreenOverlay id="khScreenOverlay756"&gt;</strong>
  &lt;name&gt;Simple crosshairs&lt;/name&gt;
  &lt;description&gt;This screen overlay uses fractional positioning
   to put the image in the exact center of the screen&lt;/description&gt;
  &lt;Icon&gt;
    &lt;href&gt;http://myserver/myimage.jpg&lt;/href&gt;
  &lt;/Icon&gt;
  &lt;overlayXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/&gt;
  &lt;screenXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/&gt;
  &lt;rotation&gt;39.37878630116985&lt;/rotation&gt;
  &lt;size x="0" y="0" xunits="pixels" yunits="pixels"/&gt;
<strong>&lt;/ScreenOverlay&gt;</strong></pre>
 
<h3>Extends</h3>
<ul>
	<li><a href="#feature">&lt;<em>Feature</em>&gt;</a></li>
	<li><a href="#overlay">&lt;<em>Overlay</em>&gt;</a></li>
</ul>
       
<h3>Contained By</h3> 
<ul> 
  <li><a href="#document">&lt;Document&gt;</a> </li>
  <li><a href="#folder">&lt;Folder&gt;</a></li>
</ul>
	
<a name="style"></a>
<h2>&lt;Style&gt;</h2>
<h3>Syntax </h3>
<pre><strong>&lt;Style id="ID"&gt;
</strong>&lt;!-- extends StyleSelector --&gt;

&lt;!-- specific to Style --&gt;
  &lt;IconStyle&gt;...&lt;/IconStyle&gt;
  &lt;LabelStyle&gt;...&lt;/LabelStyle&gt;
  &lt;LineStyle&gt;...&lt;/LineStyle&gt;
  &lt;PolyStyle&gt;...&lt;/PolyStyle&gt;
  &lt;BalloonStyle&gt;...&lt;/BalloonStyle&gt;
  &lt;ListStyle&gt;<strong>...</strong>&lt;/ListStyle&gt;<strong>
&lt;/Style&gt;</strong></pre>

<h3>Description</h3>
<p>A Style defines an addressable style group that can be referenced by
StyleMaps and Features. Styles affect how Geometry is presented in the
3D viewer and how Features appear in the Places panel of the List view.
Shared styles are collected in a &lt;Document&gt; and must have an <strong>id</strong> defined for them so that they can be referenced by the individual Features that use them. <!-- See <a href="kml_basics.html">KML Basics</a> for more information on styles. --></p>
<p>Use an <strong>id</strong> to refer to the style from a <a href="#styleurl">&lt;styleUrl&gt;</a>.  </p>

<h3>Example</h3>
<pre>&lt;Document&gt;
  &lt;!-- Begin Style Definitions --&gt;
  <strong>&lt;Style id="myDefaultStyles"&gt;</strong>
    &lt;IconStyle&gt;
      &lt;color&gt;a1ff00ff&lt;/color&gt;
      &lt;scale&gt;1.399999976158142&lt;/scale&gt;
      &lt;Icon&gt;
        &lt;href&gt;http://myserver.com/icon.jpg&lt;/href&gt;
      &lt;/Icon&gt;
    &lt;/IconStyle&gt;
    &lt;LabelStyle&gt;
      &lt;color&gt;7fffaaff&lt;/color&gt;
      &lt;scale&gt;1.5&lt;/scale&gt;
    &lt;/LabelStyle&gt;
    &lt;LineStyle&gt;
      &lt;color&gt;ff0000ff&lt;/color&gt;
      &lt;width&gt;15&lt;/width&gt;
    &lt;/LineStyle&gt;
    &lt;PolyStyle&gt;
      &lt;color&gt;7f7faaaa&lt;/color&gt;
      &lt;colorMode&gt;random&lt;/colorMode&gt;
    &lt;/PolyStyle&gt;
  <strong>&lt;/Style&gt;</strong>
  &lt;!-- End Style Definitions --&gt;
  &lt;!-- Placemark #1 --&gt;
  &lt;Placemark&gt;
    &lt;name&gt;Google Earth - New Polygon&lt;/name&gt;
    &lt;description&gt;Here is some descriptive text&lt;/description&gt;
    &lt;styleUrl&gt;#myDefaultStyles&lt;/styleUrl&gt;
    . . .
  &lt;/Placemark&gt;
  &lt;!-- Placemark #2 --&gt;
  &lt;Placemark&gt;
    &lt;name&gt;Google Earth - New Path&lt;/name&gt;
    &lt;styleUrl&gt;#myDefaultStyles&lt;/styleUrl&gt;
      . . . .
  &lt;/Placemark&gt;
&lt;/Document&gt;
&lt;/kml&gt;</pre>
 
<h3>Extends</h3>
<ul>
	<li><a href="#styleselector">&lt;<em>StyleSelector</em>&gt;</a></li>
</ul>

<h3>Contained By</h3> 
<ul> 
  <li>any <a href="#feature">&lt;<em>Feature</em>&gt;</a></li> 
</ul>
 
<h3>Elements Specific to Style</h3> 
<ul> 
  <li><a href="#balloonstyle">&lt;BalloonStyle&gt;</a></li>     
  <li><a href="#iconstyle">&lt;IconStyle&gt;</a></li>
	<li><a href="#labelstyle">&lt;LabelStyle&gt;</a></li>
	<li><a href="#linestyle">&lt;LineStyle&gt;</a></li>
	<li><a href="#liststyle">&lt;ListStyle&gt;</a></li>
	<li><a href="#polystyle">&lt;PolyStyle&gt;</a></li>
</ul>
    
<a name="stylemap"></a>
<h2>&lt;StyleMap&gt;</h2>
<h3>Syntax </h3>
<pre><strong>&lt;StyleMap id="ID"&gt;</strong>
  &lt;!-- extends <em>StyleSelector</em> --&gt;
  &lt;!-- elements specific to StyleMap --&gt;
  &lt;Pair id="ID"&gt;
    &lt;key&gt;normal&lt;/key&gt;              &lt;!-- kml:styleStateEnum:  normal<em> or</em> highlight --&gt;
    &lt;styleUrl&gt;<em>...</em>&lt;/styleUrl&gt; or &lt;Style&gt;...&lt;/Style&gt;
  &lt;/Pair&gt;
<strong>&lt;/StyleMap&gt;</strong></pre>

<h3>Description</h3>
<p>A &lt;StyleMap&gt; maps between two different Styles. Typically a
&lt;StyleMap&gt; element is used to provide separate normal and
highlighted styles for a placemark, so that the highlighted version
appears when the user mouses over the icon in Google Earth.</p> 
<!-- See <a href="kml_basics.html">KML Basics </a> for more information and examples.</p> -->

<h3>Elements Specific to StyleMap</h3>
<dl>
  <dt><strong>&lt;Pair&gt; </strong><em>(required)</em><a name="pair" id="pair"></a></dt>
	<dd>Defines a key/value pair that maps a mode (<em>normal</em> or <em>highlight</em>) to the predefined &lt;styleUrl&gt;. &lt;Pair&gt; contains two elements (both are required): 
	  <ul>
		  <li><strong>&lt;key&gt;<a name="key" id="key"></a></strong>, which identifies the key</li>
			<li><strong>&lt;styleUrl&gt;</strong><a name="styleurl" id="styleurl"></a> or <strong>&lt;Style&gt;</strong>,
which references the style. In &lt;styleUrl&gt;, for referenced style
elements that are local to the KML document, a simple # referencing is
used. For styles that are contained in external files, use a full URL
along with # referencing. For example:</li>
		</ul>
	<pre><strong>&lt;Pair&gt; </strong>
  &lt;key&gt;normal&lt;/key&gt; 
  &lt;styleUrl&gt;http://myserver.com/populationProject.xml#example_style_off&lt;/styleUrl&gt; 
<strong>&lt;/Pair&gt;</strong> </pre>
  </dd>

	
<h3>Example</h3>
<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>&lt;kml xmlns="http://www.opengis.net/kml/2.2"&gt;<br>&lt;Document&gt;<br>  &lt;name&gt;StyleMap.kml&lt;/name&gt;<br>  &lt;open&gt;1&lt;/open&gt;<br>  &lt;Style id="normalState"&gt;<br>    &lt;IconStyle&gt;<br>      &lt;scale&gt;1.0&lt;/scale&gt;<br>      &lt;Icon&gt;<br>        &lt;href&gt;http://maps.google.com/mapfiles/kml/pal3/icon55.png&lt;/href&gt;<br>      &lt;/Icon&gt;<br>    &lt;/IconStyle&gt;<br>    &lt;LabelStyle&gt;<br>      &lt;scale&gt;1.0&lt;/scale&gt;<br>    &lt;/LabelStyle&gt;<br>  &lt;/Style&gt;<br>  &lt;Style id="highlightState"&gt;<br>    &lt;IconStyle&gt;<br>      &lt;Icon&gt;<br>        &lt;href&gt;http://maps.google.com/mapfiles/kml/pal3/icon60.png&lt;/href&gt;<br>      &lt;/Icon&gt;<br>      &lt;scale&gt;1.1&lt;/scale&gt;<br>    &lt;/IconStyle&gt;<br>    &lt;LabelStyle&gt;<br>      &lt;scale&gt;1.1&lt;/scale&gt;<br>      &lt;color&gt;ff0000c0&lt;/color&gt;<br>    &lt;/LabelStyle&gt;<br>  &lt;/Style&gt;<br>  <strong>&lt;StyleMap id="styleMapExample"&gt;</strong><br>    &lt;Pair&gt;<br>      &lt;key&gt;normal&lt;/key&gt;<br>      &lt;styleUrl&gt;#normalState&lt;/styleUrl&gt;<br>    &lt;/Pair&gt;<br>    &lt;Pair&gt;<br>      &lt;key&gt;highlight&lt;/key&gt;<br>      &lt;styleUrl&gt;#highlightState&lt;/styleUrl&gt;<br>    &lt;/Pair&gt;<br>  <strong>&lt;/StyleMap&gt;</strong><br>  &lt;Placemark&gt;<br>    &lt;name&gt;StyleMap example&lt;/name&gt;<br>    &lt;styleUrl&gt;#styleMapExample&lt;/styleUrl&gt;<br>    &lt;Point&gt;<br>      &lt;coordinates&gt;-122.368987,37.817634,0&lt;/coordinates&gt;<br>    &lt;/Point&gt;<br>  &lt;/Placemark&gt;<br>&lt;/Document&gt;<br>&lt;/kml&gt;</pre>
 
<h3>Extends</h3>
<ul>
	<li><a href="#styleselector">&lt;<em>StyleSelector</em>&gt;</a></li>
</ul> 
      
<h3>Contained By</h3> 
<ul> 
  <li>any <a href="#feature">&lt;<em>Feature</em>&gt;</a></li>
</ul>
	
<a name="styleselector"></a>
<h2>&lt;<em>StyleSelector</em>&gt;</h2>
<h3>Syntax</h3> 
	<pre>&lt;!-- abstract element; do not create --&gt;
<strong>&lt;!-- <em>StyleSelector</em> id="ID" --&gt;               </strong>  &lt;!-- Style,StyleMap --&gt;<strong>
&lt;!-- /<em>StyleSelector</em> --&gt;</strong></pre>
	 <p><strong>Description</strong></p>
	 <p>This
is an abstract element and cannot be used directly in a KML file. It is
the base type for the &lt;Style&gt; and &lt;StyleMap&gt; elements. The
StyleMap element selects a style based on the current mode of the
Placemark. An element derived from StyleSelector is uniquely identified
by its <strong>id</strong> and its <em>url</em>.</p>
	 
<h3>Elements Specific to StyleSelector</h3>
<p>This abstract element does not contain any child elements. </p>
	   
<h3>Extends</h3>
<ul>
	 <li><a href="#object"><em>&lt;Object&gt;</em></a></li>
</ul>

<h3>Extended By</h3>
<ul>
	 <li><a href="#style">&lt;Style&gt;</a></li>
	 <li><a href="#stylemap">&lt;StyleMap&gt;</a></li>
</ul>
	
<a name="timeprimitive"></a>
<h2>&lt;<em>TimePrimitive</em>&gt;</h2>
<h3>Syntax</h3> 
	<pre>&lt;!-- abstract element; do not create --&gt;
<strong>&lt;!-- TimePrimitive id="ID" --&gt;            &lt;!-- TimeSpan,TimeStamp --&gt;               
 </strong> &lt;!-- extends Object --&gt;<strong>
&lt;!-- /TimePrimitive --&gt;</strong></pre>

<h3>Description</h3>
<p>This is an abstract element and cannot be used directly in a KML
file. This element is extended by the &lt;TimeSpan&gt; and
&lt;TimeStamp&gt; elements.</p>

<h3>Extends</h3>
<ul>
 <li><a href="#object">&lt;<em>Object</em>&gt;</a></li>
</ul>

<h3>Extended By</h3>
<ul>
	<li><a href="#timespan">&lt;TimeSpan&gt;</a></li>
	<li><a href="#timestamp">&lt;TimeStamp&gt;</a></li>
</ul>
		       
<a name="timespan"></a>
<h2>&lt;TimeSpan&gt;</h2>

<h3>Syntax</h3>
    <pre><strong>&lt;TimeSpan id="ID"&gt;</strong>
  &lt;begin&gt;<em>...</em>&lt;/begin&gt;     &lt;!-- kml:dateTime --&gt;
  &lt;end&gt;<em>...</em>&lt;/end&gt;         &lt;!-- kml:dateTime --&gt;
<strong>&lt;/TimeSpan&gt;</strong></pre>

<h3>Description</h3>
<p>Represents an extent in time bounded by begin and end <em>dateTimes</em>.</p>
    
<p>If &lt;begin&gt; or &lt;end&gt; is missing, then that end of the period is unbounded (see Example below). </p>
<p>The <em>dateTime</em> is defined according to XML Schema time (see <a href="http://www.w3.org/TR/xmlschema-2/#isoformats">XML Schema Part 2: Datatypes Second Edition</a>). The value can be expressed as <em>yyyy-mm-dd</em>T<em>hh:mm:ss</em>zzzzzz, where T is the separator between the date and the time, and the time zone is either Z (for UTC) or <em>zzzzzz</em>, which represents ±<em>hh:mm</em> in relation to UTC. Additionally, the value can be expressed as a date only. See <a href="#timestamp">&lt;TimeStamp&gt;</a> for examples. </p>

<h3>Elements Specific to TimeSpan</h3>
<dl>
  <dt><strong>&lt;begin&gt;<a name="begin" id="begin"></a> </strong></dt>
	<dd>Describes the beginning instant of a time period. If absent, the beginning of the period is unbounded.</dd>
	<dt><strong>&lt;end&gt;<a name="end" id="end"></a></strong></dt>
	<dd>Describes the ending instant of a time period. If absent, the end of the period is unbounded.</dd>
</dl>

<h3>Example</h3>
	<p>The following example shows the time period
representing Colorado's statehood. It contains only a &lt;begin&gt; tag
because Colorado became a state on August 1, 1876, and continues to be
a state:</p>
	<pre>&lt;Placemark&gt;
  &lt;name&gt;Colorado&lt;/name&gt;
  .
  .
  .
  <strong>&lt;TimeSpan&gt;</strong>
    &lt;begin&gt;1876-08-01&lt;/begin&gt;
  <strong>&lt;/TimeSpan&gt;</strong>
&lt;/Placemark&gt;</pre>
 
<h3>Extends</h3>
<ul>
	 <li><a href="#timeprimitive">&lt;<em>TimePrimitive</em>&gt;</a></li>
</ul> 
      
<h3>Contained By</h3> 
<ul> 
  <li>any element derived from <a href="#feature">&lt;<em>Feature</em>&gt;</a></li>
</ul> 
    
<a name="timestamp"></a>
<h2>&lt;TimeStamp&gt;</h2>
<h3>Syntax </h3>
    <pre><strong>&lt;TimeStamp id=ID&gt;</strong>
  &lt;when&gt;...&lt;/when&gt;      &lt;!-- kml:dateTime --&gt;
<strong>&lt;/TimeStamp&gt;</strong> </pre>

<h3>Description</h3>
<p>Represents a single moment in time. This is a simple element and contains no children. Its value is a <em>dateTime</em>, specified in XML time (see <a href="http://www.w3.org/TR/xmlschema-2/#isoformats">XML Schema Part 2: Datatypes Second Edition</a>). The precision of the TimeStamp is dictated by the <em>dateTime</em> value in the &lt;when&gt; element.</p>
    
<h3>Elements Specific to TimeStamp</h3>
<dl>
  <dt><strong>&lt;when&gt; <a name="when" id="when"></a></strong></dt>
	<dd>Specifies a single moment in time.  The value is a <em>dateTime</em>, which can be one of the following:
	<ul>
	  <li><em>dateTime</em> gives second resolution</li>
    <li><em>date</em> gives day resolution</li>
    <li><em>gYearMonth</em> gives month resolution</li>
    <li><em>gYear</em> gives year resolution </li>
  </ul>
</dd>
</dl>
    <p>The following examples show different resolutions for the &lt;when&gt; value:</p>
		<ul>
      <li><em>gYear</em> (<em>YYYY</em>)</li>
			
			
    </ul>
	<pre>&lt;TimeStamp&gt;
  &lt;when&gt;1997&lt;/when&gt;
&lt;/TimeStamp&gt;</pre>
    <ul>
		  <li><em>gYearMonth</em> (<em>YYYY-MM</em>)</li>
		</ul>
		
    <pre>&lt;TimeStamp&gt;
  &lt;when&gt;1997-07&lt;/when&gt;
&lt;/TimeStamp&gt; </pre>
    <ul>
      <li><em>date</em> (<em>YYYY-MM-DD</em>)</li>
    </ul>
    <pre>&lt;TimeStamp&gt;
  &lt;when&gt;1997-07-16&lt;/when&gt;
&lt;/TimeStamp&gt; </pre>
    <ul>
      <li><em>dateTime</em> (<em>YYYY-MM-DD</em><strong>T</strong><em>hh:mm:ss</em><strong>Z</strong>)<br>
    Here, T is the separator between the calendar and the hourly notation of time, and Z indicates UTC. (Seconds are required.) </li>
    </ul>
    <pre>&lt;TimeStamp&gt;
  &lt;when&gt;1997-07-16T07:30:15Z&lt;/when&gt;
&lt;/TimeStamp&gt;</pre>
    <ul>
      <li><em>dateTime</em> (<em>YYYY-MM-DD</em><strong>T</strong><em>hh:mm:sszzzzzz)<br>
        </em>This example gives the local time and then the ± conversion to UTC. </li>
    </ul>
    <pre>&lt;TimeStamp&gt;
  &lt;when&gt;1997-07-16T10:30:15+03:00&lt;/when&gt;
&lt;/TimeStamp&gt;</pre>
  
<h3>Extends</h3>
<ul>
	<li><a href="#timeprimitive">&lt;<em>TimePrimitive</em>&gt;</a></li>
</ul> 
      
<h3>Contained By</h3> 
  <ul> 
    <li>any element that extends <a href="#feature">&lt;<em>Feature</em>&gt;</a></li>
  </ul>
	
<a name="gxtimespan"></a><a name="gxtimestamp"></a>
<h2>&lt;gx:TimeSpan&gt; and &lt;gx:TimeStamp&gt;</h2>
<table class="note" width="60%">
<tbody><tr><td class="note">This element is an extension of the <a href="http://www.opengeospatial.org/standards/kml/">OGC KML 2.2 standard</a> and is supported in Google Earth 5.0. <a href="#kmlextensions">Learn more</a></td></tr></tbody></table>
<p>A copy of the <code>&lt;TimeSpan&gt;</code> and <code>&lt;TimeStamp&gt;</code> elements, in the extension namespace. This allows for the inclusion of time values in AbstractViews (<code>&lt;Camera&gt;</code> and <code>&lt;LookAt&gt;</code>). Time values are used to control <a href="http://earth.google.com/userguide/v5/ug_gps.html#historicalimagery">historical imagery</a>, sunlight, and visibility of time-stamped Features.</p>

<h3>Example</h3>
<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2"&gt;

  &lt;Document&gt;
    &lt;name&gt;Views with Time&lt;/name&gt;
    &lt;open&gt;1&lt;/open&gt;
    &lt;description&gt;
      In Google Earth, enable historical imagery and sunlight,
      then click on each placemark to fly to that point in time.
    &lt;/description&gt;

    &lt;Placemark&gt;
      &lt;name&gt;Sutro Baths in 1946&lt;/name&gt;
      &lt;Camera&gt;
        &lt;gx:TimeStamp&gt;
          &lt;when&gt;1946-07-29T05:00:00-08:00&lt;/when&gt;
        &lt;/gx:TimeStamp&gt;
        &lt;longitude&gt;-122.518172&lt;/longitude&gt;
        &lt;latitude&gt;37.778036&lt;/latitude&gt;
        &lt;altitude&gt;221.0&lt;/altitude&gt;
        &lt;heading&gt;70.0&lt;/heading&gt;
        &lt;tilt&gt;75.0&lt;/tilt&gt;
      &lt;/Camera&gt;
    &lt;/Placemark&gt;

    &lt;Placemark&gt;
      &lt;name&gt;Palace of Fine Arts in 2002&lt;/name&gt;
      &lt;Camera&gt;
        &lt;gx:TimeStamp&gt;
          &lt;when&gt;2002-07-09T19:00:00-08:00&lt;/when&gt;
        &lt;/gx:TimeStamp&gt;
        &lt;longitude&gt;-122.444633&lt;/longitude&gt;
        &lt;latitude&gt;37.801899&lt;/latitude&gt;
        &lt;altitude&gt;139.629438&lt;/altitude&gt;
        &lt;heading&gt;-70.0&lt;/heading&gt;
        &lt;tilt&gt;75&lt;/tilt&gt;
      &lt;/Camera&gt;
    &lt;/Placemark&gt;

  &lt;/Document&gt;
&lt;/kml&gt;</pre>

	
<h2><a name="gxtour"></a>&lt;gx:Tour&gt;</h2>

<table class="note" width="60%">
<tbody><tr><td class="note">This element is an extension of the <a href="http://www.opengeospatial.org/standards/kml/">OGC KML 2.2 standard</a> and is supported in Google Earth 5.0. <a href="#kmlextensions">Learn more</a></td></tr></tbody></table>

<h3>Syntax </h3>
<pre>&lt;gx:Tour&gt;
  &lt;name&gt;...&lt;/name&gt;
  &lt;description&gt;...&lt;/description&gt;
  &lt;gx:Playlist&gt;

    &lt;!-- any number of <em>gx:TourPrimitive</em> elements --&gt;

  &lt;/gx:Playlist&gt;
&lt;/gx:Tour&gt;</pre>
<h3>Description </h3>

<p><code>&lt;gx:Tour&gt;</code> can contain a single <code>&lt;gx:Playlist&gt;</code> element, which in turn contains an ordered list of <code>gx:TourPrimitive</code> elements that define a tour in any KML browser. <a href="http://code.google.com/intl/de/apis/kml/documentation/touring.html">Learn more about tours</a>.</p>

<h3>Example</h3>
<p>A number of tour examples are available from the <a href="http://code.google.com/apis/kml/documentation/touring.html">Touring</a> chapter of the <strong>KML Developer's Guide</strong>.</p>
<h3>Contains</h3>
<ul>
  <li><strong><a name="gxplaylist"></a>gx:Playlist</strong> - Contains any number of <code>gx:TourPrimitive</code> elements. There can be zero or one <code>&lt;gx:Playlist&gt;</code> elements contained within a <code>&lt;gx:Tour&gt;</code> element. 
    
    <pre>&lt;gx:Tour&gt;
  <strong>&lt;gx:Playlist&gt;</strong>
    &lt;!-- gx:TourPrimitive --&gt;
      ...
    &lt;!-- /gx:TourPrimitive --&gt;

    &lt;!--- Any number of gx:TourPrimitive elements can be included ---&gt;
  <strong>&lt;/gx:Playlist&gt;</strong>
&lt;/gx:Tour&gt;</pre>
  </li>
</ul>

<h2><a name="gxtourprimitive" id="gxtourprimitive"></a>&lt;gx:TourPrimitive&gt;</h2>
<table class="note" width="60%">
  <tbody><tr>
    <td class="note">This element is an extension of the <a href="http://www.opengeospatial.org/standards/kml/">OGC KML 2.2 standard</a> and is supported in Google Earth 5.0. <a href="#kmlextensions">Learn more</a></td>
  </tr>
</tbody></table>
<h3>Syntax</h3>
<pre>&lt;gx:Tour&gt;
  &lt;gx:Playlist&gt;

    &lt;!-- abstract element; do not create --&gt;
    <strong>&lt;!-- gx:TourPrimitive --&gt;</strong>    &lt;!-- gx:AnimatedUpdate, gx:FlyTo, gx:TourControl, gx:SoundCue, gx:Wait --&gt;
        &lt;!-- extends <strong>Object</strong> --&gt;
    <strong>&lt;!-- /gx:TourPrimitive --&gt;</strong>

  &lt;/gx:Playlist&gt;
&lt;/gx:Tour&gt;
</pre>
<h3>Description </h3>
<p>This is an abstract element and cannot be used directly in a KML file. This element is extended by the <code>&lt;gx:FlyTo&gt;</code>, <code>&lt;gx:AnimatedUpdate&gt;</code>, <code>&lt;gx:TourControl&gt;</code>, <code>&lt;gx:Wait&gt;</code>, and <code>&lt;gx:SoundCue&gt;</code> elements. </p>
<p> Elements extended from <code>gx:TourPrimitive</code> provide instructions to KML browsers during <a href="#TBD">tours</a>, including  points to fly to and the duration of those flights, pauses, updates to KML features, and sound files to play. </p>
<p>These elements must be contained within a <code>&lt;gx:Playlist&gt;</code> element, which in turn is contained with a <code>&lt;gx:Tour&gt;</code> element.</p>
<h3>Example</h3>
<pre class="long">&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;kml xmlns="http://www.opengis.net/kml/2.2"&gt;

  &lt;Document&gt;
    &lt;name&gt;gx:AnimatedUpdate example&lt;/name&gt;
    &lt;open&gt;1&lt;/open&gt;

    &lt;Style&gt;
      &lt;IconStyle id="iconstyle"&gt;
        &lt;scale&gt;1.0&lt;/scale&gt;
      &lt;/IconStyle&gt;
    &lt;/Style&gt;

    &lt;Placemark id="mountainpin1"&gt;
      &lt;name&gt;New Zealand's Southern Alps&lt;/name&gt;
      &lt;styleUrl&gt;#style&lt;/styleUrl&gt;
      &lt;Point&gt;
        &lt;coordinates&gt;170.144,-43.605,0&lt;/coordinates&gt;
      &lt;/Point&gt;
    &lt;/Placemark&gt;

    &lt;gx:Tour&gt;
      &lt;name&gt;Play me!&lt;/name&gt;
      &lt;gx:Playlist&gt;

        &lt;!-- The order and duration of TourPrimitives is important;
             in this example, the AnimatedUpdate needs
             6.5 seconds to complete. The FlyTo provides 4.1,
             and the Wait 2.4, giving the update time to
             complete before the Tour ends. AnimatedUpdates
             don't hold Tours open, but FlyTos and Waits do.

             For more information, refer to:
             http://code.google.com/apis/kml/documentation/touring.html#tourtimelines
        --&gt;

        &lt;gx:AnimatedUpdate&gt;
          &lt;gx:duration&gt;6.5&lt;/gx:duration&gt;
          &lt;Update&gt;
            &lt;targetHref&gt;&lt;/targetHref&gt;
            &lt;Change&gt;
                &lt;IconStyle id="iconstyle"&gt;
                  &lt;scale&gt;10.0&lt;/scale&gt;
                &lt;/IconStyle&gt;
            &lt;/Change&gt;
          &lt;/Update&gt;
        &lt;/gx:AnimatedUpdate&gt;

        &lt;gx:FlyTo&gt;
          &lt;gx:duration&gt;4.1&lt;/gx:duration&gt;
          &lt;Camera&gt;
            &lt;longitude&gt;170.157&lt;/longitude&gt;
            &lt;latitude&gt;-43.671&lt;/latitude&gt;
            &lt;altitude&gt;9700&lt;/altitude&gt;
            &lt;heading&gt;-6.333&lt;/heading&gt;
            &lt;tilt&gt;33.5&lt;/tilt&gt;
            &lt;roll&gt;0&lt;/roll&gt;
          &lt;/Camera&gt;
        &lt;/gx:FlyTo&gt;

        &lt;gx:Wait&gt;
          &lt;gx:duration&gt;2.4&lt;/gx:duration&gt;  &lt;!-- waiting for the AnimatedUpdate to complete --&gt;
        &lt;/gx:Wait&gt;

      &lt;/gx:Playlist&gt;
    &lt;/gx:Tour&gt;
  &lt;/Document&gt;
&lt;/kml&gt;
</pre>

<h3>Contained by</h3>
<ul>
  <li><a href="#gxplaylist">&lt;gx:Playlist&gt;</a></li>
</ul>
<h3>Extended by</h3>
<ul>
  <li><a href="#gxanimatedupdate">&lt;gx:AnimatedUpdate&gt;</a></li>
  <li><a href="#gxflyto">&lt;gx:FlyTo&gt;</a></li>
  <li><strong><a name="gxsoundcue"></a>&lt;gx:SoundCue&gt;</strong>
    <pre>&lt;gx:SoundCue&gt;
  &lt;href&gt;http://www.example.com/audio/trumpets.mp3&lt;/href&gt;   &lt;!-- any URI --&gt;
&lt;/gx:SoundCue&gt;</pre>
    Contains an <code>&lt;href&gt;</code>
element specifying a sound file to play, in MP3, M4A, or AAC format. It
does not contain a duration. The sound file plays in parallel to the
rest of the tour, meaning that the next tour primitive takes place
immediately after the <code>&lt;gx:SoundCue&gt;</code> tour primitive is reached. If another sound file is cued before the first has finished playing, the  files are mixed.</li>
  <li><strong><a name="gxtourcontrol"></a>&lt;gx:TourControl&gt; </strong>
    <pre>&lt;gx:TourControl&gt;
  &lt;gx:playMode&gt;pause&lt;/gx:playMode&gt;    &lt;!-- gx:playModeEnum: pause --&gt;
&lt;/gx:TourControl&gt;</pre>
    <a name="gxplaymode"></a>Contains a single <code>&lt;gx:playMode&gt;</code> element, allowing the tour to be paused until a user takes action to continue the tour. </li>
  <li><strong><a name="gxwait"></a>&lt;gx:Wait&gt; </strong>
    <pre>&lt;gx:Wait&gt;
  &lt;gx:duration&gt;0.0&lt;/gx:duration&gt;    &lt;!-- double --&gt;
&lt;/gx:Wait&gt;</pre>
    The camera remains still, at the last-defined gx:AbstractView, for the number of seconds specified before playing the next <code>gx:TourPrimitive</code>.
Note that a wait does not pause the tour timeline - currently-playing
sound files and animated updates will continue to play while the camera
is waiting.</li>
</ul>
<h3>Extends</h3>
<ul>
  <li><a href="#object">&lt;Object&gt;</a></li>
</ul>

  <h2><a name="update"></a>&lt;Update&gt;</h2>
<h3>Syntax </h3>
<pre><strong>&lt;Update&gt;
  </strong>&lt;targetHref&gt;...&lt;targetHref&gt;    &lt;!-- URL --&gt;
  &lt;Change&gt;...&lt;/Change&gt;
  &lt;Create&gt;...&lt;/Create&gt;
  &lt;Delete&gt;...&lt;/Delete&gt;
<strong>&lt;/Update&gt;</strong></pre>

<h3>Description </h3>
<p>Specifies an addition, change, or deletion to KML data that has already been loaded using the specified URL. The <a href="#targethref">&lt;targetHref&gt;</a> specifies the <em>.kml</em> or <em>.kmz</em>
file whose data (within Google Earth) is to be modified. &lt;Update&gt;
is always contained in a NetworkLinkControl. Furthermore, the file
containing the NetworkLinkControl must have been loaded by a
NetworkLink. See the "Topics in KML" page on <a href="http://code.google.com/intl/de/apis/kml/documentation/updates.html">Updates</a> for a detailed example of how Update works. </p>
    
<h3>Elements Specific to Update</h3>
<p>Can contain any number of &lt;Change&gt;, &lt;Create&gt;, and &lt;Delete&gt; elements, which will be processed in order. </p>
<dl>
	<dt><strong>&lt;targetHref&gt;</strong> <em>(required)<strong><a name="targethref" id="targethref"></a></strong></em></dt>
	<dd>A URL that specifies the <em>.kml</em> or <em>.kmz</em> file whose data (within Google Earth) is to be modified by an <a href="#update">&lt;Update&gt;</a> element. This KML file must already have been loaded via a <a href="#networklink">&lt;NetworkLink&gt;</a>. In that file, the element to be modified must already have an explicit <strong>id</strong> attribute defined for it. </dd>
	<dt><strong>&lt;Change&gt;<a name="change" id="change"></a></strong></dt>
	<dd>Modifies the values in an element that has already been loaded with a <a href="#networklink">&lt;NetworkLink&gt;</a>. Within the Change element, the child to be modified must include a<strong> targetId</strong> attribute that references the original element's <strong>id</strong>.</dd> 
  <dd>This
update can be considered a "sparse update": in the modified element,
only the values listed in &lt;Change&gt; are replaced; all other values
remained untouched. When &lt;Change&gt; is applied to a set of
coordinates, the new coordinates replace the current coordinates.</dd>
	<dd> Children of this element are the element(s) to be modified, which are identified by the <strong>targetId</strong> attribute.</dd>
	<dt><strong>&lt;Create&gt;<a name="create" id="create"></a></strong></dt>
	<dd>Adds new elements to a Folder or Document that has already been loaded via a <a href="#networklink">&lt;NetworkLink&gt;</a>. The <a href="#targethref">&lt;targetHref&gt;</a> element in <a href="#update">&lt;Update&gt;</a> specifies the URL of the <em>.kml</em> or <em>.kmz</em>
file that contained the original Folder or Document. Within that file,
the Folder or Document that is to contain the new data must already
have an explicit <strong>id</strong> defined for it. This <strong>id</strong> is referenced as the <strong>targetId</strong> attribute of the Folder or Document within &lt;Create&gt; that contains the element to be added.</dd>
	  <dd>Once
an object has been created and loaded into Google Earth, it takes on
the URL of the original parent Document of Folder. To perform
subsequent updates to objects added with this Update/Create mechanism,
set &lt;targetHref&gt; to the URL of the original Document or Folder
(not the URL of the file that loaded the intervening updates).</dd>
		<dt><strong>&lt;Delete&gt;<a name="delete" id="delete"></a></strong></dt>
    <dd>Deletes features from a complex element that has already been loaded via a <a href="#networklink">&lt;NetworkLink&gt;</a>. The <a href="#targetHref">&lt;targetHref&gt;</a> element in <a href="#update">&lt;Update&gt;</a> specifies the <em>.kml</em> or <em>.kmz</em> file containing the data to be deleted. Within that file, the element to be deleted must already have an explicit <strong>id</strong> defined for it. The &lt;Delete&gt; element references this <strong>id</strong> in the <strong>targetId</strong> attribute. </dd>
    <dd>Child
elements for &lt;Delete&gt;, which are the only elements that can be
deleted, are Document, Folder, GroundOverlay, Placemark, and
ScreenOverlay.</dd>     
</dl>
	
<h3>Example of &lt;Change&gt;</h3>
     <pre>&lt;NetworkLinkControl&gt; 
  &lt;Update&gt; 
    <strong>&lt;targetHref&gt;http://www/~sam/January14Data/Point.kml&lt;/targetHref&gt;</strong> 
    <strong>&lt;Change&gt; </strong>
      &lt;Point targetId="point123"&gt; 
        &lt;coordinates&gt;-95.48,40.43,0&lt;/coordinates&gt;
      &lt;/Point&gt; 
    &lt;/Change&gt; 
  &lt;/Update&gt; 
&lt;/NetworkLinkControl&gt; </pre>

<h3>Example of &lt;Create&gt;</h3>
<p>This example creates a new Placemark in a previously created Document that has an <strong>id</strong> of "region24." Note that if you want to make subsequent updates to "placemark891," you will still use <em>http://myserver.com/Point.kml </em>as the &lt;targetHref&gt;.</p>
     <pre>&lt;Update&gt; 
  <strong>&lt;targetHref&gt;http://myserver.com/Point.kml&lt;/targetHref&gt;</strong> 
  <strong>&lt;Create&gt;</strong>
    &lt;Document <strong>targetId="region24"</strong>&gt;
      &lt;Placemark id="placemark891"&gt; 
        &lt;Point&gt; 
          &lt;coordinates&gt;-95.48,40.43,0&lt;/coordinates&gt; 
        &lt;/Point&gt;
      &lt;/Placemark&gt;
    &lt;/Document&gt; 
  <strong>&lt;/Create&gt; </strong>
&lt;/Update&gt; 
</pre>

<h3>Example of &lt;Delete&gt;</h3>
<p>This example deletes a Placemark previously loaded into Google
Earth. (This Placemark may have been loaded directly by a NetworkLink
with the specified URL, or it may have been loaded by a subsequent
Update to the original Document.) </p>
     <pre>&lt;Update&gt; 
  <strong>&lt;targetHref&gt;http://www.foo.com/Point.kml&lt;/targetHref&gt; 
  &lt;Delete&gt;</strong>
    &lt;Placemark targetId="pa3556"&gt;&lt;/Placemark&gt;
  <strong>&lt;/Delete&gt;</strong> 
&lt;/Update&gt; </pre>

<h3>Contained By</h3>
<ul> 
  <li><a href="#networklinkcontrol">&lt;NetworkLinkControl&gt;</a></li> 
</ul>
	
<a name="url"></a>
<h2>&lt;Url&gt;</h2> 
<p class="note"><strong>Note:</strong> This element was deprecated in KML Release 2.1 and is replaced by <a href="#link">&lt;Link&gt;,</a> which provides the additional functionality of <a href="#region">Regions</a>. The &lt;Url&gt; tag will still work in Google Earth, but use of the newer &lt;Link&gt; tag is encouraged.</p> 
<p>Use this element to set the location of the link to the KML file, to
define the refresh options for the server and viewer changes, and to
populate a variable to return useful client information to the server.</p> 
     
<p class="backtotop"><a href="#top">Back to top</a></p>


   
      </dl></dl></dl></dl><div style="height: 79119px;" id="gc-collapsible"></div></div><!-- end gc-pagecontent -->
   </div><!-- end gooey wrapper -->

    </div> <!-- end codesite content -->

<div id="gc-footer" dir="ltr">
  <div class="text">
    
    ©2009 Google -
    <a href="http://code.google.com/">Code Home</a> -
    <a href="http://www.google.com/accounts/TOS">Terms of Service</a> -
    <a href="http://www.google.com/privacy.html">Privacy Policy</a> -
    <a href="http://code.google.com/more/">Site Directory</a>
    <br> <br>
    Google Code offered in:
    <a href="http://code.google.com/intl/en/">English</a> -
    <a href="http://code.google.com/intl/es/">Español</a> -
    <a href="http://code.google.com/intl/ja/">日本語</a> -
    <a href="http://code.google.com/intl/ko/">한국어</a> -
    <a href="http://code.google.com/intl/pt-BR/">Português</a> -
    <a href="http://code.google.com/intl/ru/">Pусский</a> -
    <a href="http://code.google.com/intl/zh-CN/">中文(简体)</a> -
    <a href="http://code.google.com/intl/zh-TW/">中文(繁體)</a>
  </div>
</div><!-- end gc-footer -->

</div><!-- end gc-containter -->

<script type="text/javascript">CODESITE_CSITimer['load'].tick('ats');</script>
<script src="kmlreference22_ext-Dateien/codesite_tail.js" type="text/javascript"></script>








  <div style="position: absolute; top: 19px; left: 1147px; display: none;" id="menuDiv-projects-dropdown" class="menuDiv instance0"><b style="display: block;" class="categoryTitle projects">Projects</b><div class="menuCategory projects first"><a href="http://code.google.com/p/javaapiforkml/" style="display: block;" class="menuItem">javaapiforkml</a><a href="http://code.google.com/p/rockonfuzzytool/" style="display: block;" class="menuItem">rockonfuzzytool</a><a href="http://code.google.com/p/xjcpluginjavaapiforkml/" style="display: block;" class="menuItem">xjcpluginjavaapiforkml</a></div><b style="display: block;" class="categoryTitle starred_projects">Starred projects</b><div class="menuCategory starred_projects"><a href="http://code.google.com/p/javaapiforkml/" style="display: block;" class="menuItem">javaapiforkml</a><a href="http://code.google.com/p/rockonfuzzytool/" style="display: block;" class="menuItem">rockonfuzzytool</a></div><div class="menuCategory controls"><hr class="menuSeparator"><a href="http://code.google.com/more/" style="display: block;" class="menuItem">Find developer products...</a><a href="http://code.google.com/hosting/" style="display: block;" class="menuItem">Find open source projects...</a></div></div><div style="position: absolute; top: 19px; left: 1243px; display: none; width: 175px;" id="menuDiv-lang-dropdown" class="menuDiv instance1"><div class="menuCategory default first"><a href="http://code.google.com/intl/en/apis/kml/documentation/kmlreference.html#iconstyle" style="display: block;" class="menuItem">English</a><a href="http://code.google.com/intl/es/apis/kml/documentation/kmlreference.html#iconstyle" style="display: block;" class="menuItem">Español</a><a href="http://code.google.com/intl/ja/apis/kml/documentation/kmlreference.html#iconstyle" style="display: block;" class="menuItem">日本語</a><a href="http://code.google.com/intl/ko/apis/kml/documentation/kmlreference.html#iconstyle" style="display: block;" class="menuItem">한국어</a><a href="http://code.google.com/intl/pt-BR/apis/kml/documentation/kmlreference.html#iconstyle" style="display: block;" class="menuItem">Português (Brasil)</a><a href="http://code.google.com/intl/ru/apis/kml/documentation/kmlreference.html#iconstyle" style="display: block;" class="menuItem">Pусский</a><a href="http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlreference.html#iconstyle" style="display: block;" class="menuItem">中文 (简体)</a><a href="http://code.google.com/intl/zh-TW/apis/kml/documentation/kmlreference.html#iconstyle" style="display: block;" class="menuItem">中文 (繁體)</a></div></div><div id="gc-collapsible-arrow"></div><div style="left: 181px; top: 71px; width: 345px;" id="cs-searchresults"><div id="cs-recommended">Suggestions</div><div id="searchResult1"></div><div id="searchResult2"></div><div id="searchResult3"></div><div id="searchResult4"></div><div id="searchResult5"></div><div id="searchResult6"></div><div id="searchResult7"></div></div></body></html>